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Title 

System 80 OS/3 Job Control Programming Reference Manual 

This announces the release of Update B to this document 

Job control is the part of the operating system that manages system resources, prepares programs for execution, and starts 
program execution. . . . . , . 

This manual provides the programmer with reference information on how to use job control to direct and control the flow of jobs 
through the system. ; .. . , * .. 

This update includes the following technical changes: / ■ - - - ^ - 

• SYSM64 parameter has been added to Sie ASM jproc. - - - i-- ■ : . - ---r -\ . 

• BUFMODE parameter has been added to the DD job control statement. ^ v: ■. ■ : 

• Logical unit number assignments have been added Tor 96i0 disk'and 5073 tape. 

All other changes are corrections, deletions, or expanded descriptions applicable to items present in the software prior to this 
release. 

You can order the update only or tiie complete manual witii the update. To receive only the update, order UP-9984 Rev. 2-B. To 
receive tiie complete manual, order UP-9984 Rev. 2. 

To order additional copies of this document: 

• United States customers should call Unisys Direct at 1-800448-1424. 

• All otiier customers should contact their Unisys Subsidiary Librarian. 

• Unisys personnel should use tiie Electronic Literature Ordering (ELO) system. 

See important notice on tiie back of tiiis sheet. 
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Title 

System 80 OS/3 Job ConilbroB Programmiinig Refeirance Manual 

This announces the release of Update A to this document 

Job control is the part of the operating system that manages system resources, prepares programs for execution, and starts 
program execution. 

This manual provides the programmer with reference information on how to use job control to direct and control the flow of jobs 
through the system. 

This update includes the following technical changes: 

• MEM parameter has been removed from the CAT job control statement 

• ALTJCS job control statement allows use of multiple alternate libraries. 

• New parameters on INQ SYS job control statement provide day of week, month, or year. 

• New values are provided for TYPE parameter on LCB and VFB job control statements. 

• SPOOL job control procedure (JPROC) RECORDS parameter and SPL job control statement max-rec parameter accept a 
new value 0. 

• SPL job control statement UPD/NOUPD parameter has been enhanced to allow control of the SPOOLUPDATE function 
regardless of the SYSGEN specification. 

• TYPE parameter has been added to USE LIB job control statement to specify module type. 

• The following JPROCS have been added: CCOMP, C0BL85, FOR77. and PASCAL. 

® Logical unit number assignments have changed for a number of tape devices. 

All other changes are corrections, deletions, or expanded descriptions applicable to items present in the software prior to this 
release. 

You can order the update only or the complete manual with the update. To receive only the update, order UP-9984 Rev. 2-A. To 
receive the complete manual, order UP-9984 Rev. 2. 

To order additional copies of this document 

• United States customers should call Unisys Direct at 1-800-228-9224. 

• Ail other customers should contact their Unisys Subsidiary Librarian. 

• Unisys personnel should use the Electronic Literature Ordering (ELO) system. 

See Important notice on the back of this sheet 
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About This Manual 



Purpose 



o 



This programming manual is one in a series to be used by programmers familiar with 
the Unisys Operating System/3 (OS/3). This particular manual contains descriptions 
of the job control statements and procs used in a System 80 environment to 
communicate with job control and the proc definition statements that allow you to 
expand and conditionally modify the control stream when you start a job. 

Audience 

The intended audience for this mcuiual is the programmer, who will use job control to 
direct and control the flow of jobs through the system. 

How to Use This Manual 

This manual is applicable to all System 80 models. Read tiiose sections of the manual | 

that apply to your system and familiarize yourself with the basic concepts; then use 
the manual for reference as needed. 

Organization 

This manual is divided into four sections and two appendixes. 

Section 1. Generallnformation 

Describes the control stream concepts. 

Section 2. Job Control Statements 

Describes the function and parameters of each job control statement in alphabetical 
order by statement mnemonic. 

Section 3. Job Control Procs 

Describes the function and parameters of each job control proc in alphabetical order by 
proc mnemonic. 
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Section 4. Proc Definition Statements 

Describes the function and parameters of each proc definition statement in 
alphabetical order by statement name. 

Appendix A. Logical Unit Niunber Assignment Information 

Provides the information needed to assign or change the logical unit niunbers of the 
peripheral devices in a system. 

Appendix B. Extent Specification Infonnation 

Provides the information required to establish or to extend a disk or diskette file. 

Related Product Information 

The following Unisys documents may be useful in understanding and implementing 
OS/3's job control. 

Note: Use the version that applies to the software level in use at your site. 

Job Control Programming Guide, 7004 4623 

This guide describes OS/3 job control and explains how to use it. 

Interactive Services Operating Guide, UP-9972 

This guide describes the procedures used to communicate interactively with the 
operating system through a local workstation or remote terminal. 

System 80 Models 8-20 OS/3 Operations Guide, 7004 5208 

This guide describes the hardware configuration of the System 80 models 8-20 and 
presents procedures for initializing the system. It also covers all the commands and 
procedures used in the OS/3 environment. 

System 80 Models 8^20 OS/3 Operations Quick-Reference Guide, 7004 5224 

This quick-reference guide summarizes the procedures and commands used by OS/3 in 
a model 8-20 environment. 

System 80 Model 7E OS/3 Operations Guide, 7002 3866 

This guide describes the hardware configuration of the System 80 model 7E and 
presents procedxn-es for initializing the system. It also covers all the commands and 
procedures used in the OS/3 environment. 
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System 80 Model 7E OS/3 System Operations Quick-Reference Guide, 
7002 3882 

This qmck-reference guide summarizes the procedures and commands used by OS/3 in 
a model 7E environment. 

System 80 Model 50 Basic Operations Guide, 7004 1934 

This guide summarizes the procedures and commands used by OS/3 in a model 50 
environment. 

System 80 Model 50 Detailed Operations Guide, 7004 1942 

This guide describes the hardware configuration of the System 80 model 50 and 
presents procedures for initializing the system. It also covers all the commands and 
procedures used in the OS/3 environment. 

File Cataloging Technical Overview, 7004 4615 

This overview discusses file cataloging and describes the facilities provided for it in a 
System 80 environment. 

Supervisor Macroinstructions Programming Reference Manual, UF-8832 

This manual describes the OS/3 supervisor macroinstructions used for program 
management, file space management, file access multitasking, and spooling. 

Consolidated Data Management Programming Guide, UP-9978 

This guide describes consolidated data management and how it moves data between 
peripheral devices and programs. 

Consolidated Data Management Macroinstructions Programming Guide, 
7004 4607 

This guide describes the macroinstructions used by consolidated data management, 
which are used in assembly language programs to define data files and manage the 
movement of data to and from those files. 

1974 American Standard COBOL Programming Reference Manual, 7004 4490 

This manual describes 1974 ANS COBOL for the applications programmer. It 
includes the COBOL character set, character strings, methods of reference, and the 
statements permitted in each COBOL division. 

System 80 Models 8-20 Installation Guide, 7004 5505 

This guide provides the information and procedures needed to install, tailor, smd 
maintain OS/3 software in a System 80 models 8-20 environment. 
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System 80 Model 7E Installation Guide, 7002 3858 

This guide proviiles the information and procedures needed to install, tailor, and 
maintain OS/3 software in a System 80 model 7E environment. 

System 80 Model 50 Installation Guide, 7004 1892 

This guide provides the information and procedures needed to install, tailor, and 
maintain OS/3 software in a System 80 model 50 environment. 

Screen Format Services Technical Overview, IJP-9977 

This overview describes how you can move information easily through your computer 
system using the OS/3 screen format services. 

Menu Services Technical Overview, UP-9317 

This guide describes the OS/3 menus and explains how to use them with assembly, 
COBOL, RPG II, and FORTRAN IVT" programs. 

Dialog Processor Programming Guide, UP-8858 

This guide describes the dialog processor, which is the interface between the dialog 
(written in dialog specification language) and the application program using the 
dialog. 

Distributed Data Processing Programming Guide, 7004 4508 

This guide describes distributed data processing and the corresponding products, 
including the DDP transfer facility and the DDP file access. 

Statement Conventions 

The conventions used to illustrate the coding formats presented in this manual are: 

• Information that must be coded exactly as shov/n is presented in uppercase 
letters. Commas, equals signs, parentheses, slashes, and percent signs also must 
be coded as shown. 

• Information that can take various forms is presented in lowercase letters. 



FORTRAN IV is a trademark of SuperSoft Associations. 
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Unless otherwise indicated, all parameters are positional parameters and must 
be coded in the order specified in the operand field and separated by commas. 
When a positional parameter is omitted, its associated comma must be retained 
to indicate the omission, except in the case of omitted trailing parameters. For 
example, the control statement: 



// [synbol] LFD 



•r file 
I *fil 



ename 1 
ename] 



r 1 


1 


'M 


' EXTEND 1 


8 


EXTEND 


L -1 


IGNORE 




INIT 




. PREP J 




J 



could be coded in any of the following ways: 

// LFD DISKIN,1,INIT 
// LFD DISKIN,,PREP 
// LFD DISKIN 



O 



Keyword parameters, which take the form 

ICEYWORD=variable 

can be coded in any sequence following the last positional parameter. Keyword 
parameters of the type 



KEYWORD 



can be coded in random sequence only when it is indicated in the text 
accompanying the control statement; otherwise, they must be coded as positional 
parameters. 

A job control statement may consist of a group of positional parameters followed 
by a keyword parameter (as the last parameter). 



Example 



//[symbol] EXEC program-name 



library- name 
$Y$RUN 



C,C+]switch-priority][,ABNORM=label] 



C 



Since the last parameter is a ke3nvord (not the last positional) parameter, this 
statement may be written as follows: 

// EXEC program- name, ABN0RM= label 

// EXEC program-name,library-nane,ABNORM=label 
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Commas for the omitted positional parameters may be retained if desired. For 
example: 

// EXEC program-name,,, ABNORH=label 

// EXEC program- name, library name,, ABNORM= label 

The conventions for coding commas when a positional parameter is omitted and 
subsequent positional parameters are being specified still apply. When the 
second positional parameter is omitted, for example, the EXEC statement must 
be coded as follows: 

// EXEC program - name,, sw Itch-pri on* ty,ABNORM= label 

Information that may be coded optionally is enclosed in brackets: 



c 



optional 
information 



When more than one option exists for any given parameter, the options are listed 
within braces: 



option- 1 
option-2 
option-n 



Parameters enclosed in parentheses are called subparameters and are subject to 
the same rules as parameters. The parentheses enclosing subparameters must be 
coded to delimit a series of one or more subparameters. 

An ellipsis (. . .) is used to indicate the omission of a variable number of similar 
parameters: 

lun-2, type-code, --., lun-5 , type-code 

Optional parameters that have a default specification are shaded: 
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{library- name 1 



When a portion of a parameter is underlined, only that portion need be specified. 
For example: 

FORMNAHE=symbol 

can be coded as 

FO=symbol 
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Job Control Overview 

Job control is one of the two components of the Unisys Operating System/3 (OS/3) 
executive; the other component is the supervisor. Job control consists of a series of 
transient routines and is activated by a job control statement or an operator command 
input from the system console. Using these transient routines, job control manages 
system resources and prepares a job for execution. 

Specifically, job control 

• Analyzes the input control stream. 

• Expands job control procedure calls. 

• Allocates peripheral devices and main storage. 

• Schedules jobs for execution. 

Job control directs and controls the flow of jobs through the system. The environment 
of a job and its various job steps are defined and controlled by job control statements 
in a control stream. As the control stream is processed, job control calls on transient 
routines to perform the required functions. A control stream may be read into the job 
control stream library ($Y$JCS), or an alternate SAT library file for permanent 
storage, or into a temporary job run library file ($Y$RUN) for scheduling and 
execution. Jobs are scheduled for execution based on a priority scheme and the 
availability of system resources. If the required resources are available for a job in the 
highest priority queue, the job is executed. A job is executed one job step at a time 
imtil the job is completed. Housekeeping is performed as part of the job termination 
process. 
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Control Stream Concepts O 

A control stream is a series of job control statements and job control procedures 
(jprocs) that define the job and direct its execution (Figure 1-1). It acts as an interface 
between the job and the operating system. It may also include source code or data as 
required by the job. 

One control stream is applicable to only one job; each job is subdivided into one or 
more steps and a temporary $Y$RUN file is created for each job. Any number of jobs, 
however, may be stored on disk for subsequent sdieduUng. From 1 to 47 jobs can be 
active concurrently, depending on the availability of system resources and the 
configuration of your system. Each job and, therefore, each control stream stored on 
disk must be given a unique name. 

Job control assigns a job number to every active job and symbiont for identification 
purposes. When the job number reaches the maximum of 9999, job control resets it to 
20. 

Figure 1-1 illustrates a job control stream for a job divided into several job steps. 
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JOB STEP 



JOB STEP 



JOB STEP 
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Note: Devices allocated (through DVCIFD sequences) for one job step are available to all succeeding job steps. 
Figure 1-1. Typical Control Stream 
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Job Control Statements ^ 

Each job control statement is described in alphabetical order in Section 2. The 
parameters associated with a statement are described in the order of their appearance 
when the statement format is scanned from left to right and from top to bottom within 
a parameter. If a default condition for a multiple-option parameter is available, it is 
shaded. 

General Format 

A job control statement has a maximum of five fields, which appear in the following 
order: 

® Indication field 

Distinguishes job control statements from data. It is required and begins with //, 

/&,/$, or/*. 

• Label field 

Contains an alphanumeric character symbol, of which the first character must be 
alphabetic. Unless this field is explained in a specific control statement, it is the 
target address of a SKIP control statement or the ABNORM keyword parameter 
of the EXEC statement. This field is not separated from the indication field by a 
space; it immediately follows the //. 

® Operation field 

Contains the name of the function to be performed. It is required for all job 
control statements having an indication field of// and must be preceded by a 
blank. 

• Operand field 

Contains the specific information concerning the items upon which a job control 
function is to operate or the manner in which the function is to be performed. 
This field must be preceded by a blank. 

• Comments field 

Contains any descriptive information desired, but not processed. The field must 
not contain a slash character. For those job control statements in which an 
operand is not permitted, such as the FIN control statement, all information 
beyond the operation field is treated as the comments field. This field must be 
preceded by a blank. 

Excluding the indication and label fields, consecutive fields must be separated by one 
or more spaces. A space may not appear in a field except within apostrophes 
(hexadecimal code 7D) or parentheses in an operand field. 
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Example 



/./■M.Y.r>.<?AA.P, L.B.L. . : . ^.WA.S.TE.R. ,C,U.S.T/ 



fJAM.E Ft.L.t. 




1 . Indication field 
3. Operation field 

5. Comments field 



2. Label field 

4. Operand field 

Note that spaces are allowable due to the use of 
apostrophes. 

6! Field separation spaces 
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Coding Conventions 

• Data cannot be contained in a job control statement. 

• Embedded data is normally assumed to be 80 characters long; input from diskette 
can be 80 or 128 characters long. 

• Comments must not contain a slash. 

• Job control does not scan past position 72; however, embedded data of up to 128 
bytes is passed through. Positions 72 through 80 may also be used for a 
continuation character and sequencing. 

• For multiple-statements on one line: 

Each statement, except the last, is terminated by one or more blanks 
followed by the first slash of the next statement. 

Statements are processed from columns 1 through 71, Column 72 is used to 
indicate continuation. 

- CR and procname must be the last statement on the line. 

Any statement may be continued at any delimiter, such as the blanks 
following the operation or operand fields or after the comma following a 
parameter in the operand field. A nonblank character must be coded in 
colunm 72. 
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JOB, FIN, PROC, NAME, or END must be the only statement on a line. 

/$, /*, or /& must be the only statement on a line. 

Numbers required for particular parameters can be expressed in decimal or 
hexadecimal form. Numbers preceded by D and enclosed in single quotes are 
considered decimal. Numbers preceded by X and enclosed in single quotes are 
considered hexadecimal. (A traihng quote may be specified optionally.) Both of 
the following represent the same value: 

XTF 

D*255' 

Nimibers not preceded by X or D are automatically considered decimal except in 
the following cases when they default to hexadecimal: 

Main storage sizes specified on the JOB statement (min and max 
parameters) 

Main storage sizes specified on the OPTION MIN and OPTION MAX job 
control statements 

Absolute disk addresses specified on the EXT statement iaddr or Tccc:hh 
parameters) 

Address on the ALTER statement {address parameter) 

Expansion limit on the SFT statement's DLOAD option {expansion-limit 
parameter) 

Character strings on the ALTER, LCB, and SET job control statements must be 
specified as shown in their formats. 



Statement Continuation 



A continuation Une is not considered a statement in itself. It is a line that contains the 
continuation of the immediately preceding control statement. A nonblank character 
must appear in column 72 of each statement being continued. Continuation 
statements may be used to extend any job control statement for which at least the first 
two fields are already coded. 

A continuation line must begin with either the three-character sequence //n, or just a 
simple //, separated by one or more blanks from the continuation portion of the control 
statement. The general format of the continuation statement is: 

//Cn]p1,...,pn 
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where: 
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Is a decimal number from 1 through 9. The numbers do not need to be 
consecutive; however, each successive niimber must be greater than or equal 
to the preceding number within a specific group of continuation statements. 
This is an optional field and may be left blank, or numbers may be used so 
the user can keep a visual record of the amount of continuation statements 
used. 

p1,...,pn 

Are the parameters required to continue the immediately preceding 
statement. 

Any statement may be continued at Einy delimiter. The delimiters are the blanks 
following the operation or operand fields, or after the comma following a parameter in 
the operand field. Subparameters may not be divided. 

Job Control Procs 

The job control procs supplied as part of OS/3 are described in alphabetical order in 
Section 3. The parameter descriptions are presented in the same order specified for 
the job control statements. The coding formats of these procs are illustrated in the 
proc descriptions, using the statement conventions previously described. 

Proc Definition Statements 

A job control procedure definition consists of a PROC definition statement, one or 
more NAME definition statements, and a series of job control statements; it ends with 
an END definition statement. The PROC definition statement is used to signal the 
beginning of the procedure, the NAME definition statement declares labels by which 
the procedure can be called for execution, and the END definition statement signals 
the end of the procedure. Each time a series of job control statements is needed, a 
procedure call statement is written; job control then inserts the necessary number of 
statements at the point of reference. The procedure definition specifies the coding and 
statements for a particular operation to job control, and the procedure call statement 
specifies the values of the variable parameters to be used when the call is executed. 



Coding Conventions 



Statements and comments used in procedure definitions are generally written in 
columns 1 through 71. Column 72 is used to indicate continuation. Columns 73 
through 80 may contain program identification and sequencing information; job 
control does not process these columns. 
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The job control statements within the body of the procedure definition follow 
standard job control statement conventions with respect to multiple-statement 
cards and continuation. If multiple-statement images are present in the 
procedure definition, they are expanded and passed to the run symbiont one 
statement at a time. If job control statements with continuation appear in the 
body of the procedure definition, they are expanded and passed to the run 
symbiont in the same form with continuation. Job control does not attempt to 
verify whether continuation is allowed on the particular control statement. 

Character Set 

The character set used in writing procedure definition statements consists of: 

Letters A through Z (upper and lower case) 

Special letters ?$# @ 

Digits through 9 

Special characters +-*/, = ' blank ().><& ! : ; 



Terms 



The values that may be used in the operand field of a procedure definition statement 
may be a symbol or a character string. 

• Symbols 

A symbol consists of a group of up to eight alphanumeric characters used for 
parameter identification and as labels. The first, or leftmost, character must be 
alphabetical. Special characters or blanks may not be contained within a symbol. 

The label on a NAME directive cannot exceed a length of eight characters. The 
operand in a NAME directive may be obtained by referencing the symbol p(0), 
where p is the symbol assigned in the PROC directive used to reference any 
positional parameter in the defimition, and (0) is the number of the positional 
parameter. The parameter in the operand of the NAME directive is addressed as 
positional parameter 0. 

• Character string 

A character string can represent up to 252 valid characters, all of which must be 
printable. Character strings containing embedded blanks or commas must be 
enclosed in apostrophes or parentheses, which are considered part of the 
character string. A character string may not contain an embedded apostrophe. 

A null character string is represented by two consecutive apostrophes. 

All parameter values are evaluated as character strings. 
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Parameters 



Parameters pass information from the procedure call statement, through the 
procedure definition, to the body of the procedure. Parameters may be equated to 
values, symbols, or character strings and may be used to specify label information, file 
names, volume serial numbers, etc. There are two types of parameters: positional and 
keyword. Positional parameters are identified by their position within the operand 
field of the procedure call statement; keyword parameters are referenced or identified 
by the symbols assigned to them in the directive. 

Both positional and keyword parameters may be sublisted. Thus, each operand of the 
procedure call statement may represent one value or a series of values that may be 
referenced independently. When a parameter is sublisted, the subparameters must be 
separated by commas and the entire list enclosed in parentheses. 

An omitted positional parameter has the value of a null character string. An omitted 
keyword parameter that had a preset value specified in the PROC directive is given 
that preset value. An omitted kejnvord subparameter that had a preset value specified 
in the PROC directive is not given that preset value. If no preset value was given, the 
value of the keyword parameter is a null character string. 



Parameter Referencing 
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Job control statements coded in the body of a procedure definition follow the same 
rules and conventions as all other job control statements, with one exception. The 
parameters in the operand field of the job control statements that require substitute 
values at job execution time must begin with an ampersand (&). The positional 
parameters in the operand field of the job control statements, whose values will be 
changed when the procedure definition is called, must have some sort of symbol 
included in the parameter specification. For example, in the body of a procedure 
definition, if you had a DVC statement in which you want to vary the logical unit 
number, it would be coded: 

// DVC &P(2) 

The ampersand (&) is the indicator; the P is the symbol you assigned in the PROC 
directive; the (2) indicates that the logical unit number to be inserted in the control 
statement is coded as positional parameter 2 in the procedure call statement. The 
parentheses are required. 

Parameter substitution is performed at job execution time by the run symbiont when 
it expands the procedure definition. 

Siabstitution is attempted only on your embedded procedure call statements. PROC or 
NAME directives are not candidates for substitution. 
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For each vaKd character string following a single ampersand, a substitution is made. ^-^ 

If a valid siiibstitution exists, it is used; if no valid substitution exists, the null 
character string is substituted. 

The ampersand, period, parentheses, apostrophe, blank (delta), comma, plus, minus, 
asterisk, and slash (& . ( ) "^ , + - * /) may not be embedded in the dummy arguments 
on the PROC directive. 

Any statement can be continued only between operands or between the command and 
the first operand. This limits the length of operands on the input source (primary 
control stream or procedure file) to 65 characters. 

The length of a single operand may not exceed 252 characters. 

The length of a single parameter is limited to 242 characters. For positional 
parameters, this is the value field; for kesrword parameters, this is the value plus the 
key length. If a parameter is sublisted, the maximum length is decreased by 2 for each 
element of the subUst. 

Control Stream Considerations 

Procedure definitions are filed by the file symbiont in either $Y$JCS or an alternate 

library file. The new values to be used are not substituted for the preset values until 

the procedure definition is called. Substitution takes place then and the procedure ^^~x 

definition is expanded. A procedure definition may be called as often as necessary or v v 

until the procedure definition is deleted firom $Y$JCS or the alternate hbrary file. 

A job input directly from the card reader may include procedure definitions in its 
control stream. Procedure definitions must appear in the control stream before any 
references are made to them. They may not be embedded in a data sequence 
(statements /$ through /*). 

A procediire definition filed in $Y$JCS or an alternate library file may be overridden 
by reading in a new version firom the card reader, a diskette, or the system spool file. 
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System Library File Names 



The i^stem library files for OS/3 are called by their file identifiers. These allow a 
program to access a file via its symbolic name. In this way, a file is not device 
dependent, and the programmer is not hampered by physical device restrictions in the 
program specifications. The file identifiers used for the ^stem library files are: 



Load libraiy file 
Object library file 
Source library file 



$Y$LOD 
$Y$OBJ 
$Y$SRC 



Macro libraiy file $Y$MAC 

Job control stream library file $Y$JCS 

A temporaiy job run libraiy ($Y$RUN jobname) is also established for each job input 
to the system. These files exist only for the duration of the job, unless the job's 
$Y$RUN file is saved through the OPTION SAVE or OPTION NOSCHED job control 
statement. 
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G Section 2 

Job Control Statements 



ALTER 

Function 



Alters load modules at execution time. ALTER control statements must precede 
the EXEC control statement in the job step. ALTER control statements are 
processed by the supervisor prior to the transfer of control to the user program. 



Format 

//[symbol] ALTER [phase - name ][,acUress][, change] 

Parameters 



J RESET 1 
JORG I 



O 



phase -name 

One to eight alphanumeric characters specifying the name of the phase to be 
altered. If less than eight characters are specified, the phase being altered is 
assumed to be an alias phase and the name is padded on the right with 
EBCDIC blanks to make eight characters. The names of all other phases 
must be specified by using the full eight characters. 

If omitted, the previously named phase is altered. 

address 

A 1- to 5-digit address that specifies the main storage location into which the 
bytes specified by positional parameter 3 are to be stored; considered 
hexadecimal if coded JCnumhef or number, and decimal if coded D'numhef. 
If positional parameter 4 is BESET, the address may be omitted. 

If omitted and an address is required, zero is used. 
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change 

Specifies the contents of the bytes to be stored at the address specified by 
positional parameter 2. Changes are not stored if the address is invalid. The 
change must be specified in hexadecimal or EBCDIC. 

• Hexadecimal 

X»cccccccc...» or cccccccc... 

The number of characters must be even, and the maximum nimiber of 
hexadecimal characters allowed is 16 (eight bytes). 

• EBCDIC 

C< cccccccc' 

The maximum number of EBCDIC characters allowed is 8 (eight bytes). 

If positional parameters 2 and 3 are omitted, this is a null ALTER control statement, 
and control is returned to the user program. 

If positional parameter 4 is used, change may be omitted. 

RESET 

Resets the alter mode indicator. If all other parameters are omitted, control 
returns to the user program with the alter mode indicator reset. 

ORG 

Adds the address specified in positional parameter 2 to all addresses on 
succeeding ALTER control statements until the next ALTER control 
statement with a RESET parameter is encountered or the final ALTER 
control statement for the phase is processed. 

If RESET or ORG is not specified, the control stream is read until an ALTER control 
statement with the RESET or ORG parameter is detected or the final ALTER control 
statement for the phase is processed. 
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Function 



Specifies an alternate SAT library file (one other than $Y$JCS) to be searched for 
jprocs. The alternate library file can be located on format-label diskette as well 
as disk. 



Format 



//[symbol] ALTJCS [file-label-id] 



RES 


C,rpH] 


t 


FREE 1 


RUN 






ONLY 


vol-sep-no 






OFF 








[m J 








. 



C,LUN=nnn3 



Parameters 
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file-label-id 

A 1- to 44-alphanumeric character label name of the file to be searched for 
jprocs; it is optional only if you're not activating the search of a new library 
but changing the last parameter (FREE, ONLY, OFF, or ON) for an 
alternate library already defined in a previous ALTJCS statement. If the 
file-label'id is not specified, then vol-ser-no and rpw cannot be specified. 

vol-ser-no 

Specifies the volume serial number of the file to be searched for jprocs. If a 
vol-ser-no is not specified, the cataloged vol-ser-no is used; if it is not 
cataloged, RES is used. 



rpw 



Specifies the read password of the specified cataloged file that contains the 
jprocs needed for the job. 



FREE 



Specifies that only $Y$JCS is to be searched and frees the alternate device 
(from the run processor) after the search is completed. 



ONLY 



Specifies that only the identified alternate library file is to be searched. 
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OFF 



Specifies that only $Y$JCS is to be searched. You specify this option if you 
no longer want an alternate Hbrary file searched for jprocs. The alternate 
library file remains open to the run processor and can be searched again by 
using the ON or ONLY options. 



c 



ON 



Specifies that the identified alternate library file is to be searched first and 
then $Y$JCS is to be searched; ON is the default order-of-search option. 

LUN=nnn 

Supplies a logical unit number indicating the device type and characteristics 
for the alternate library; never specified unless a volume serial number is 
also specified; helps to determine whether a disk or format-label diskette is 
required (since volume serial numbers for disk and for format-label diskette 
are syntactically the same). 

Note: The run processor searches only the specified alternate library for jprocs. 

Specify ALTJCS ,„FREE to revert to the prior order of search (alternate library 
and then $Y$JCSl The FREE option must also be specified before another 
ALTJCS statement can be specified. 
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CAT 

Function 



o 



Catalogs the file defined in a previously encountered device assignment set in the 
job. The file is identified by the Ifdname parameter in this statement and in the 
LFD job control statement. The read/write passwords are specified in the LBL job 
control statement. 

Format 

//[symbol] CAT lfdnaniet,catpw]E,SCRK,GEN=nn3 

Parameters 

Ifdnone 

File name which must agree with the file name of the associated LFD job 
control statement. 

catpw 

Password of one to six alphanumeric characters for the catalog itself; must 
be specified if the catalog is password protected. 

Note: Even if all the files in a file catalog have been decataloged (using 1 1 
DEC AT), the catalog password remains in effect. Catalog passwords 
are established, removed, and changed through the JC$CAT routine, 
which is explained in the File Cataloging Technical Overview, 
7004 4615. When you use 1 1 CAT or 1 1 DECATyou must specify 
catpw if a password has been established through the JC$CAT 
routine, 

SCR 

Indicates the file should be scratched when it is removed from the catalog. 
This parameter is effective only for specific references. (If several files are 
removed from the catalog as a result of the specification of a nonterminal 
node point, this parameter is not effective.) 

GEN=nn 

Number of generations to maintain for the file. 
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Information is deleted by Update A. 
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CC 

Function 
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Allows you to issue OS/3 system commands from within a job control stream. 
Parallels the functions of OS/3 system console and workstation commands. 

Format 

//[symbol] CC J conmand 1 

[ ■conmand and parameters ■ j 

Parameters 

command 

A single system console or workstation command. 

■command and parameters* 

System console or workstation command and associated parameters; total 
number of characters enclosed in quotes cannot exceed 60. 

Notes: 

1. When the command string contains no blanks (other than the blank 
separating the command from its first parameter), you can precede the first 
parameter with a comma instead of enclosing the command and its 
parameters in quotes. For example: 

It cc BE.JOBi instead of // cc 'be jobi* 

2. The following system console commands may not be specified in the CCjob 
control statement: MIX, SWITCH, AVR, REBUILD, SHUTDOWN, 
SYSDUMP, and all SET commands. 

3. Unsolicited input messages (see the Interactive Services Operating Guide, 
UP'9972) and 1 1 PAUSE responses cannot be specified in the 1 1 CC 
statement 

See the appropriate operations guide for a description of the system console commands. 
See the Interactive Services Operating Guide, UP'9972, for a description of the 
workstation commands. 
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CR 

Function 



Temporarily inserts embedded data or other job control statements from cards, 
data-set-label diskette, or spool file into a stored control stream. This statement 
can be used in control streams or procedures filed in $Y$JCS or an alternate 
library. The CR control statement is placed in the control stream at the point 
where data is to be inserted. The data from the input reader is merged with the 
filed control stream, and the combined control stream is examined by the job 
control routines. The data read firom the card reader must be terminated by a 
PIN control statement. 

Any number of CR control statements may appear in a control stream, provided 
the FIN control statement for a previous CR statement is encountered before the 
ciurent CR control statement. 

Format 

//[symbol] CR 
The CR statement contains no parameters. 
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DATA FILEID 

Function 
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A control statement used by the input reader. It identifies and precedes any input 
card data that's going to be spooled as the result of the IN operator command. 

Format 

// DATA FILEID=fUe-!dentifierE,RETAIN3[, IGNORE] 

Parameters 

FILEID=file- identifier 

File identifier. Agrees with either the file-identifier of the LBL control 
statement for the file or a concatenation of ^ejobname fi-om the JOB control 
statement and the filename fi'om the LFD control statement. 

RETAIN 

Used to maintain the spool file afl^r the job has processed the file. The only 
means of deleting the reader file after RETAIN has been specified is by 
issuing the operator console command DE SPL,RDR. 

IGNORE 

Specifies that // RUN/RV statements in the card deck that are to be spooled 
are to be processed as data cards. 

Note: If the LBL control statement is used in the device assignment set for a spooled 
card file, then the file-identifier of the DATA control statement must be the same 
as the file-identifier of the LBL control statement 
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DATA STEP 

Function 

A control statement that identifies replacement embedded data for a saved and 
translated job control stream. It must precede the replacement data stabmitted 
from a card reader, a data-set-label diskette, or a input spool file. 

Format 

// DATA STEP=nnn 

Parameters 

nnn 

A decimal number in the range 1 to 255 that specifies the number of the job 
step in the job for which you are submitting new embedded data. 

Notes: 

1. A DATA STEP statement must be submitted for each job step that contains 
embedded data you want to replace. You must replace the old data sets in the 
specified job step with an equal number of new data sets. 

2. Because the replacement embedded data is submitted to the saved translated ( j) 
stream from an input device, you must use the SI command or the 1 1 CC SI job ^-""^ 
control statement to initiate the job stream run. 

3. The embedded data is replaced for that job run only. 
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DD 



Function 



Provides a way to change certain data definitions at run time. The DD statement 
must appear within the DVC-LFD sequence. If the file is a cataloged file, it must 
follow the LBL statement. 



c 



//[symbol] DD 



RCFM= 


' FIXBLK ] 




FIXUNB 


■ 


UNDEF 




VARBLK 




[ VARUNB J 



C,BKS2=n][,RCSZ=n]C,SI2E=AUT0]CSIZEn=n] 



, J KLEN ■|=n ,r KLOC l=n 
I KLENn J I KLOCn J 



[,INDS=n3 



,ACCESS= 



EXC 

EXCR 

SRDO 

SRD 

SADD 

UCP 

SRDF 



,REUIND= 



J NORWD 1 
\ UNLOADJ 



[,OPRW=NORWD] 



C,TPMARK=NO] 



,CLRW= 


■ NORWD 1 


,FILABL= 


■ NO ] 




RUD 




NSTD 




FREE 




STD 




assign] 


L 


-I 



,RECV= 


■ ALL 
YES 






LOAD 
NO 
FCE 
OFF 





,VSEC= 



r YES 1 ,VMNT=r ONE 1 
In} 1 NO j 



,RCB=r NO 1 
I YES I 



C,0FFSET=1] 



,RESTORE=r 



= r n 1 ,CACHE=r NO 1 
t YES I I YES j 



,MSGSUPP= 



DM36 
LB05 
ALL 



C,BUFMODE=NO] 



C 
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Parameters 

The n that is sioffixed to the KLEN and KLOC keywords refers to KEYn of a 
multikey MIRAM disk file. The n that is suffixed to the SIZE keyword refers to 
the partition identifier of a multikey MIRAM disk file. The definitions for 
keyword parameters that are associated with each file type are found in the 
Consolidated Data Management Programming Guide, UP-9978. Definitions for 
the keyword parameters associated with SAT files are found in the Supervisor 
Macroinstructions Programming Reference Manual, UP-8832. Tables in the Job 
Control Programming Guide, 7004 4623, provide a summary of the allowable 
keywords for each file type. 

The SYSGEN parameter DMRECV=YES acts the same as RECV=YES. Refer to 
the Consolidated Data Management Programming Guide, UP-9978, and the 
appropriate installation guide and systems operations quick-reference guide for 
more information. 

The RESTORE^ parameter allows you to restore a MIRAM file that was 
accidentally initialized, n specifies the number of records that data management 
is to use for file retrieval. YES means to use this parameter only to read the data 
partition of the file (PCAl) for the purpose of recreating the file with a copy 
program such as DATA or MILOAD. You cannot access the index partition 
(PCA2). 

The MSGSUPP parameter optionally allows you to suppress the display of the (^^^^ 

DM36 DUPLICATE RECORD error message, the LB05 MODULE NOT FOUND V^^ 

error message, or all error messages fi-om the console or log. 
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(^ DECAT 

Function 



Removes a file from the catalog. The file is defined by the Ifdname parameter in 
this statement and in the LFD job control statement. 



Format 



//[symbol] DECAT lfdnameC,catpw]C,SCR3 



Parameters 



IS} 



O 



Ifdname 

File name, which must agree with the file name of the associated LFD job 
control statement. 

catpw 

Password of from one to six alphanumeric characters in length for the 
catalog itself; it must be specified if the catalog is password protected. 

Note: Even if all the files in a file catalog have been decataloged (using 1 1 
DECAT), the catalog password remains in effect. Catalog passwords 
are established, removed, and changed through the JC$CAT routine, 
which is explained in the File Cataloging Technical Overview, 
7004 4615, When you use 1 1 CAT or 1 1 DECAT you must specify 
catpw if a password has been established through the JC$CAT 
routine. 



SCR 



GEN 



ROL 



c 



Scratches the file when it's removed from the catalog. (See the CAT job 
control statement.) 



Removes all generations of the file from the catalog. 



Used to reset a generation file's status to its condition before the current 
generation was added. ROL (rollback) removes the current member of a 
generation file, making the previous member current, and inserts the rolled- 
back file as the oldest member of the generation file. 

Note: ROL can only be used against the current member of a generation file, 
and it can only apply once to the current member within a single job. 
Since generation file updating is done at user program termination, 
ROL is no longer needed if the job is deleted or if the job terminates 
prior to user program execution. 
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DST Q 

Function 

Sends spooled output (print or punch) to RBP (remote batch processing) 
terminals. This statement must appear in the device assignment set for the print 
or punch file. 

Format 

//[symbol] DST dest-1[,de8t-2,...,dest-16] 

Parameters 

dest-n 

Destination identifier of one to six alphanumeric characters in length; it is 
defined by RBP. Specify 0S3CTR or CENTRAL to specify the local site's 
control printer. 

Note: Although the DST statement can be used in DDP-initiatedjobs, DDP or 

auxiliary printer output (specified by 1 1 ROUTE) and RBP output (specified 
by 1 1 DST) cannot be mixed for any one job. For any job, all output must be 
of one type or the other. 



o 
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DVC 



Function 



Requests the assignment of a peripheral device to a job. The device must be 
available before the job can be scheduled and is allocated by job control at job step 
time. Specific devices can be requested and assigned. 

This statement must be the first in a device assignment set, and one set is 
required for each file. A device assignment set consists of the DVC, VOL, EXT, 
LBL, and LFD statements. At least one DVC statement and one LED statement 
are required for each file accessed by the user program. The EXT and LBL 
statements are optional. The VOL statement is required for tape and disk files. 
For catalog files, the EXT statement must follow the LBL statement. 

The maximum number of unique devices allowed in a job is 255. The maximum 
number of unit record devices (e.g., card readers, data-set-label diskettes, 
printers) allowed in one job is 42. 



Format 



//[symbol] DVC 



O 



nnnC<n)] 

RES 

RUN 



acidr 

ALT 

OPT 

IGNORE 

I 



REQC(n)] 

REAL 



[,H0ST=host-id] 



Parameters 

nnnC(n)] 

Decimal logical unit number specifying a device type and features from the 
system's logical unit table (Table A-1). When a job is scheduled, each logical 
unit number is assigned to a specific device. The device type and features for 
a logical unit number may be changed with the EQU job control statement. 

When the device is a workstation, (n) is used to specify the number of 
workstations that can access a single workstation file. A maximiun of 255 
workstations of the type specified by nnn can be associated with one file. 
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DVC 



RES 



RUN 



addr 



Notes: ^ — ■' 

1. If more than one volume is assigned the same logical unit number, the 
operator may he required to demount the first volume and then mount the 
next volume on the same device. All volumes but the last are unshareable 
with other jobs because they must be demounted. 

2. If a single volume is assigned more than one logical unit number in 
different job steps, the operator may be required to demount the volume 
from the device assigned to the first logical unit number and then mount 
the volume on the device assigned as the next logical unit number. The 
volume is not shareable with other jobs until it is mounted on the last 
device. 

3. Before a mount is requested, the system tests to determine if the required 
volumes are mounted on other devices. 

4. You cannot use logical unit numbers 50 through 59 on the DVC 
statement you use to catalog a disk file. These logical unit numbers 
specify "any type" of disk. To ensure that cataloged files obtain a valid 
device when a job is scheduled, you must use logical unit numbers that 
specify a particular kind of device. For example, you could specify 1 1 
DVC 64 to indicate that an 8416 disk is to be used. 

Use the system-resident device. The VOL statement is not required when ( y ' 

RES is specified and will be ignored if it is present. ^^'^ 

Use the device containing the job's $Y$RUN file. The VOL statement is not 
required when RUN is specified and will be ignored if it is present. 

Physical address of the device, in hexadecimal. This represents the channel 
number, the control unit address, and the device number. The use of this 
parameter inhibits dynamic allocation of devices. 

Notes: 

1. The bAAc parameter may be used to specify a real device in a spooling 
system. Real devices and virtual devices (of the same type) may not be 
assigned in the same job. 

2. The addr parameter of the DVC job control statement was not designed 
for tape, disk, or diskette, but will function correctly if the specified 
volume is not premounted on another unit Also, the specified unit cannot 
bepremounted with any volume specified in the same job stream. 
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DVC 



O 



ALT 



OPT 



The same type and features may be assigned (within a single job step). If an 
alternate device is not available, the job will execute with a single device. 

The ALT parameter of the DVC job control statement does not work 
correctly if it is used more than once in a job stream. A separate drive is 
allocated for each ALT, and if there are insufficient drives to accommodate 
all of the ALTs, only one drive is allocated even if two drives are available. If 
the ALT function is needed more than once in a job stream, the following job 
control statements can be used: 

// DVC 90 // VOL A 
// DVC 91 // VOL B 



Requested device is not essential to the running of the job. 



o 



IGNORE 

More than one logical file may be assigned to a physical device. Use this 
parameter when different files are used on one device in a serial manner by 
a job step. 

Note: When the IGNORE parameter is specified in the DVC statement, the 
logical unit number and the volume specified in the VOL statement 
must stay the same if repeated in the job stream. The following job 
control is incorrect. 

II DVC 90, IGNORE // VOL A LFD A // EXEC A 
// DVC 91 // VOL A // LFD B 

DVC 91 should be DVC 90. 



Indicates input spooling was configured for the diskettes at SYSGEN time. 



Indicates output spooling was configured for the diskettes at SYSGEN time. 

REQ[(n)] 

Used for workstations. When a number is specified for (n), this parameter 
indicates how many workstations specified in nnn[(n)] must be connected 
before the job is run. If Oi^ is omitted in this parameter, all workstations 
specified in nnn[(n)] are required. 
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REAL 

Used to assign a real device to a job, without having to specify the device's 
physical address. This parameter can be used to bypass spooling. 

H0ST=host-id 

Indicates that a disk file is located at a remote DDP host. The host-id is from 
one to four alphanumeric characters in length and identical to the label-id of 
the LOCAP macroinstruction in your ICAM network. You can specify 
$HOST instead of a host-id to indicate a remote originator (the host that 
initiated the job). The specified host-id or $HOST must always be for a 
remote host; otherwise, a data management error will result. 

Notes: 

1. The logical unit number of a DVC statement associated with a VOL 
SCRATCH statement must be unique in the job stream. A VOL SCRATCH 
statement cannot be specified as follows: 

// DVC 98 // VOL X // LFD X // EXEC A 
// DVC 90 // VOL SCRATCH // LFD Y 

The NOV parameter can be used in place of VOL SCRATCH, 
The following is permitted: 

II DVC 90 // VOL SCRATCH // LFD X // EXEC A 
// DVC 90 // VOL X // LFD Y 

Once the unique logical unit number 90 is specified for VOL SCRATCH, 90 
can be used in subsequent steps. 

2. The logical unit number in the DVC statement and the volume in the VOL 
statement must stay the same if repeated in the job stream. The following job 
control statement is incorrect: 

// DVC 50 // VOL PACKI // LFD A // EXEC PROGRAM 
// DVC 51 // VOL PACKI // LFD B 

This job requires two disk drives to be allocated but the volume PACKI is 
declared nonshareable. DVC 51 should be DVC 50. 

In situations where a job sits on the job queue for a long period of time for no 
apparent reason, the DVC and VOL statements for the job should be checked 
for the condition shown in the preceding example. 

The job control stream for a job cannot specify more than 44funit record 
devices, that is, printers, readers, and punches. 
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DVC PROG 
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DVC PROG 

Function 



o 



Allows a BAL program (using consolidated data management macros) to 
communicate with another BAL program via DDFs program-to-program facility; 
it can be specified only once in any single job step. Used in place of// DVC when 
the device assignment set is for a program-to-program lype of file; the device 
assignment set may include an LBL statement but must include an LFD 
statement. 

Format 

//[symbol] DVC PROG [, jobn8ine]C,H0ST=hostM*d] 

Parameters 

jobname 

Any 1- to 6-character job name. Identifies the other participant in the 
program-to-program communication. (When specified in // DVC PROG for 
the primary, for example, it identifies the surrogate. When specified in // 
DVC PROG for the surrogate, it identifies the primary.) This parameter is 
required in the // DVC PROG statement for the primary but is optional for 
the surrogate. 

H0ST=host-id 

Specifies a particular host in a DDP network. The host-id is one to four 
alphanumeric characters long and is identical to the label-id of the LOCAP 
macroinstruction in your ICAM network. Use $HOST to indicate the 
originator (the host that initiated the job). 



n 
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EQU 



Function 

Equates a logical unit number specified in the control stream with a device type 
in your system. This enables you to run on a system other than the one the 
control stream was designed and generated for. The EQU statement must be 
used to assign additionsd logical unit numbers to virtual readers, printers, and 
punches. 

The EQU statement must precede the device assignment set in the control 
stream that references the devices and is effective for the entire job. 

Format 

//[symbol] EQU lun-1,type-1C,lun-2,type-2,...,lun-n,type-n3 

Parameters 

lun-n 

Logical unit number specified in the control stream. The valid logical unit 
numbers are shown in Appendix A. 

type-n 

Code of four to eight hexadecimal characters that provide the exact device {^~^'^ 

characteristics (Appendix A). V.^^ 
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EXEC 



Function 



Identifies the program to be executed. The EXEC control statement is a job step 
delimiter and is the last control statement processed by job control before the 
execution of the program named in the statement. Any PARAM control 
statements included in the control stream must immediately follow an EXEC 
statement. 

The EXEC control statement loads the specific program from either $Y$LOD, the 
job's $Y$RUN file, or from an alternate load library previously defined by a 
device assignment set. 

Before actual program loading Job control completes any pending tape and disk 
mounting requests. The specified program is then loaded, overlaying job control, 
and receives control. 



Format 



//[symbol] EXEC program- name 



O 



library -name 
$Y$RUN 

mm 



C,C+]switch-priority]C,ABNORM=label] 



Parameters 

program-name 

1- to 6-character name identifying the program to be executed. It must be the 
same as the load module name specified to, or generated by, the linkage 
editor. The name is left-justified in the field and zero filled to the right, if 
necessary. 

library- name 

LFD name of the previously defined library file (on disk) containing the load 
module. Use this parameter when the program must be loaded from an 
alternate load library. If the program cannot be found, $Y$LOD and the job's 
$Y$RUN file, in that order, are searched. 



$Y$RUN 



Load user program from the job's $Y$RUN file. If the program cannot be 
found, $Y$LOD is searched for the program. 

If positional parameter 2 is omitted, $Y$LOD is searched first and if the 
program cannot be found, the job's $Y$RUN file is searched. 
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[+]switch-priority 

Decimal number specifying the program task switching priority; used by the 
supervisor for dispatching control during program execution. The number 
specified can be an absolute value ranging from 1 to 60 or a relative value 
such as +3 or -3. With absolute values, the lower number represents the 
higher priority. (The highest priority is 1.) Relative values increment or 
decrement the overall absolute task switching priority set for a job via the 
SWITCH operator command or // OPTION PRI. A positive value (+) 
decrements the overall priority resulting in a higher task switching priority 
for that program. A negative priority increments the overall priority resulting 
in a lower task switching priority for the program. If switch-priority is 
omitted, the lowest priority in the system is used. Task switching is 
explained in the Supervisor Macroinstructions Programming Reference 
Manual (UP-8832). 

Notes: 

1. Program switch list priority 

When the step processor has given control to the program, it switches the 
task to a priority (if any) placed in the preamble by the supervisor. This 
priority is specified on a new console command option - switch to priority 
for rest of job. If this priority is not in the preamble, the priority passed 
by the RUN processor is used. 

The priority passed by the run processor is one of the following: 

• The one explicitly specified on the EXEC statement 

• The one specified on a new run processor option, OPTION PRI- job 
priority, which will be applicable from the point of encounter to the 
end of job or until another such OPTION is encountered in the job 
stream 

• The system default, which currently is taken from a new field in the 
System Information Block (SIB) 

2. Relative switch list priority 

The priority specified on the 1 1 EXEC statement is an absolute value, e.g., 
3. The user specifies that the priority will change relative to the overall 
job priority for that job step only (e.g., +3 or -3). 
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ABNORMAL abet 

Used to bypass job control statements in case the program that is named 
terminates abnormally. The label corresponds to the label specified in the 
optional label (symbol) field of a subsequent job control statement. Should 
abnormal termination occur Job control skips forward to this statement. 
Since ABNORM=label is a ke3rword parameter, it may be coded in any 
position, for example: 

// EXEC MYPR0G,ABN0RH=ERR 



V.» 
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Function 

Obtains disk or diskette space. Provides the information that is needed to create 
new files or extend existing files on disks or diskettes. 

Any number of extents may be specified on a single EXT statement or on several 
EXT statements. The first EXT statement in a DVC-LFD sequence applies to the 
first volume specified on the immediately preceding VOL statement. If multiple 
extents are specified for disk or format-label diskette files, the specifications 
given for the first four positional parameters apply to all extents specified on that 
statement. When allocating catalog files that require an EXT statement, // EXT 
must follow // LBL in the device assignment set. 

See Appendix B for further information regarding extent specification. 

Format 1: Disk or Format-Label Diskette 



//[symbol 



] EXTJ HI 1 
JST j 



t 


c 1 


§ 


[ fn^l 


« 


[ ^^^ 1 




CF 




e 




Tccc:hh 




L F J 




[i J 




ra 


L J 


L J 




TBLK 






CYL 






TRK 






. OLD J 










L 


. 



.fnij 1,. 

1 (bj.aj) \ 



[,OLD][,FIX][NTERN] 



'\ (bi.al) I 



o. 



Format 2: Data-Set-Label Diskette 

//[symbol] EXT MI,C,e,BLK,(bi\ai)[,NDI] 

Parameters 

HI 

MIRAM file, only valid specification for data-set-label diskette. 



ST 



System access technique (SAT) file. 



c> 
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EXT 



c 

Allocates contiguous space; only valid specification for a data-set-label 
diskette file. 

F 

Formats the file at allocation time. Positional parameter 4 must be BLK 

CF 

Both of the preceding. 

inc 

Specifies the secondary increment in cylinders by which the file is to be 
extended if automatic extension is required. If no EXT statement is in this 
file, the value of the most recently specified secondary increment for this file 
is used, which could be the veiy first time this file was used. 



Pile cannot be dynamically extended; must be specified for a data-set-label 
diskette file. 

addr 

Absolute cylinder address where the file is to begin; considered hexadecimal 
if you code X dumber' or number; considered decimal if you code D'number', 
The allocation is in terms of cylinders. 

Tccc:hh 

Absolute track address in cylinder/head format where the file is to begin; 
considered hexadecimal if you code JCnumber or number (for example, 
TX^nnn'ix'nn' or Tnnn:nn); considered decimal if you code D'number (for 
example, TD'nnn'rD'nn'). Allocation is in terms of tracks. 

Allocates space in blocks; actual allocation is in terms of cylinders. This is a 
request for a new extent; only valid specification for data-set-label diskette 
files. 

TBLK 

Allocates space in blocks; actual allocation is in tracks. 

CYL 

Allocates space in cylinders. 

TRK 

Allocates space in tracks. 
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OLD 

Indicates that parameter 3 is being used to change the secondary increment 
(the automatic allocation amount for dynamic extension) of the extent for a 
previously allocated file. 

Cannot be followed by any other parameters even if they are specified. 

mi 

Number of cylinders or tracks allocated for this file; positional parameter 4 
must be CYL, addr, TRK, or Tccc:hh. 

(bi,ai) 

Used when allocation is in terms of blocks (by cylinder or track) for disk and 
diskette files; positional parameter 4 must be BLKor TBLK. 

bi 

Is the average block length. 

ai 

Is the number of blocks. 

mj £md (bj,aj) 

Provides the same function as mi and (bi,ai) parameters but are used only 
for additional extents in the file; not to be specified for data-set-label 
diskette files. 

OLD 

Indicates the file's previously allocated extent is to be increased by the 
allocation amount specified (mi, (bi,ai), etc). It OLD is omitted, the request is 
for a new extent. 

FIX 

Indicates you're allocating the extent in the fixed-head area of an 8417 disk. 
Note that you can specify FIX and OLD in any order so that if you omit OLD 
there's no need to retain the comma. 

NTERM 

System alerts you if the extent cannot be allocated because of insufficient 
disk space or because a specified absolute disk area is already in use. Your 
job does not terminate. Instead, the system displays a JC48 message and 
waits for either a retry (R) or cancel (C) reply. This allows an operator to 
evaluate the files currently on the disk and to clear those that are not needed 
so your job can continue. 
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NDI 

NDI (nondata interchange) must be specified to allocate space for all data- 
set-label diskettes that are not basic data exchange (BDE) diskettes. If 
omitted, a BDE diskette (a single-sided, single-density diskette having 128- 
byte sectors, 26 sectors per track, and 73 tracks) is assumed. 

Notes: 

1. All the parameters (except FIX) that apply to disk also apply to format-label 
diskette. 

2. Data files must be allocated as MIRAM files. 
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FIN C 

Function 

Terminates card reader operations. Used as a sentinel card to signal the end of 
card input to the run symbiont. If// FIN is used to signal the termination of card 
reader operations when a job is being read, it must be preceded by a /& control 
statement. 

This statement is also used to terminate card reader operations that are initiated 
by a FILE operator command when complete control streams or procedure 
definitions are filed or by an IN operator command when card input is being 
spooled. 

Format 

//[symbol] FIN 

There are no parameters associated with this statement. 
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FREE 

Function 



o 



Releases volumes and peripheral devices assigned to a job. Released volumes and 
devices, including related alternate devices, are returned to the pool of 
unallocated system resources and are available to fulfill requirements later in the 
job or for subsequent assignment to other jobs unless required by later job steps. 

Format 

//[symbol] FREE Ifdname-I [(DEV)3,...,lfdname-n C(DEV)] 

Parameters 

Ifdname 

File name previously defined in a DVC-LFD control statement sequence. 

(DEV) 

The device and voliune containing the file are released. 

Note: You should always specify the (DEV) parameter even though it's shown as 
optional. Additionally, you must specify (DEV) to free unit record devices, 
such as card readers and punches, printers, and workstations. 
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GBL ^ 

Function 

Global status is given to the named set symbols. This statement may appear 
anywhere in the job stream, and the symbols are global from the point of 
encounter forward. When defining a set i^ymbol, an ampersand is not to be 
included on the global declaration. In the run processor, an ampersand always 
means substitution and is not part of the symbol name. 

Format 

//Isymbol] GBL set-id-lCsinit-l]C,8et-id-2C-init-2] ,...,set-id-nl=init-n]] 

Parameters 

set- id- 1 through set- f d-n 

Name of the set symbol that is to have global status. 

=init-1 through =init-n 

Value given to set-id if the variable has not been previously defined as being 
global. If previously defined, init is ignored. 

Note: Whenever a quoted value is assigned to a set symbol (using 1 1 GBL), the quotes 
are considered part of the value (for example, if 1 1 GBL X^*ABC\ then &X is 
'ABCO. 
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GO 

Function 



o 



Causes an unconditional branch, in a forward direction, to another control 
statement. GO is acted upon during run processor time (prior to the job's 
execution), unlike the SKIP job control statement, which is acted upon at 
execution time. 

Format 

//[symbol] GO destination 

Label 

symbol 

Identifier that is used if this control statement is to be the target of another 
GO or IF control statement. 

Parameter 

destination 

Identifier of the target control statement that is to receive control; it must 
agree with the name in the label field of the receiving control statement. 
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IF ^ 



Function 

Causes a conditional branch, in a forward direction, to another control statement. 
IF is acted upon during run processor time (prior to the job's execution), unlike 
the SKIP job control statement, which is acted upon at execution time. 

Format 

//[symbol] IF (a op b)destination 

Label 

symbol 

Identifier that is used if this control statement is to be the target of a 
preceding GO or IF control statement. 

Parameters 

a op b 

Conditional branch test values: 



a and b 



op 



Are the operands to be compared; can be either alphabetic or numeric; |) 

(a run processor error results if one is alphabetic and the other is \^ 

numeric). If a numeric comparison is done and neither operand is 
numeric, both the greater than and less than conditions are set, 
resulting in all conditions except eqvial being allowed to branch. If a 
character comparison is being done and the two operands are not the 
same length, the comparison is made on the number of characters, 
rather than on the contents of the operands. 



Relational operator: 

EQ a equal to b 

NE a not equal to 6 

GT a greater than 6 

LT a less than 6 

GE a greater than or equal to 6 

LE a less than or equal to b 

The comparand and the relational operator are separated by spaces. 
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IF 



destination 

Identifier of the target control statement that is to receive control if the 
transfer condition is true. This must agree with the name in the label field of 
the receiving control statement. 

Notes: 

1. If the operands to he compared by an IF statement contain embedded blanks, you 
must use 1 1 JSET to replace the values before you can compare the operands. 

2. Whenever you enclose an operand in quotes, the quotes are considered part of the 
operand. For example, the two operands in Ca'EQ a) are not considered equal. 



o 



UP-9984Rev.2 2-33 



INQ JOB 



INQ JOB 



o 



Function 

Through the use of symbols, INQ JOB allows you to examine job-related values 
and to determine the availability of certain facilities. 

Format 

//symbol INQ JOB, keyword 

Label 

symbol 

Symbol name. 

Parameter 

keyword 

One of the following keywords that assigns the specified value to symbol: 

NAME Assigns the job name. 

ORI Assigns the user-id of the originator. 

HOST Assigns the host-id of the originator (null value if none). 

ORID Assigns the device-id of the originator (if a local workstation). 

WKS Assigns if a job is not initiated from a workstation. 

Assigns 1 if a job is initiated from a workstation. 
DDP Assigns if remote DDF is not initiated. 

Assigns 1 if remote DDP is initiated. 
JBNO Assigns a 4-byte job number. 
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INQ SYS 

Function 



Through the use of symbols, allows you to examine system-related values and to 
determine the availability of certain facilities. 

Format 

//symbol INQ SYS, keyword 

Label 

symbol 

Symbol name. 

Parameter 



keyword 



One of the following keywords that assigns the specified value to symbol: 

RES Assigns the SYSRES volume serial number. 

RUN Assigns the SYSRUN volume serial number. 

DATE Assigns the system date (YY/MM/DD). 

DAY Assigns the day of week (Sunday = 1, Monday = 2, etc.). 

MM Assigns the month (01 through 12). 

DD Assigns the day of month (01 through 31). 

YY Assigns the year (specify last two digits). 

TIME Assigns the system time (HH.MM.SS.). 

HOST Assigns the system's own host-id. 

CDM Assigns if consolidated data management is not configured. 

Assigns 1 if consolidated data management is configured. 

DDP Assigns if DDP is not configured. 

Assigns 1 if DDP is configured. 

JUL Assigns the Julian date YYDDD. 

WKS Assigns if workstation support is not configured. 

Assigns 1 if workstation support is configured. 
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S80 Assigns 07 if ninning on model 7E. ^-" 

Assigns 08 if running on model 8. 
Assigns 10 if running on model 10. 
Assigns 15 if running on model 15. 
Assigns 20 if running on model 20. 
Assigns 50 if running on model 50. 

SPL Assigns if spooling is not configured. 

Assigns 1 if spooling is configured. 

REL Assigns the system release-id (w.r.rr). 

SUP Assigns the supervisor name. 
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JNOTE 

Function 



o 



Displays a message at the system console or specific workstations. JNOTE is 
acted upon by the run processor, before a job is put into execution. 

Format 

//[symbol] JNOTE conment-line [,clestination-1,...,destination-n] 
Parameter 

comnent-line 

Comment or message to be displayed; may contain up to 60 characters. If the 
message contains embedded blanks, the slash character, or commas, the line 
must be enclosed in single quotes. 

destination (where destination=Chost-id:]user-id) host- id 

In a DDP environment, directs the message to a particular host; is from one 
to four alphanumeric characters long and is identical to the label-id of the 
LOCAP macroinstruction in your ICAM network. You can specify $HOST to 
indicate the originator/master host. The host-id is optional but, if specified, 
must be followed by a user-id. If the host-id is omitted, the local host is 
assumed. 

user- id 

Directs the message to a particular workstation; can be any 1- to 6- 
alphanumeric character workstation user-id, the keyword OPERATOR 
or $Y$CON (denoting the console workstation), or $Y$ORI (denoting the 
job's originator workstation). $Y$ORI is the defaidt. 

If you omit a destination, the message goes to the originator workstation. A 
message sent to an originator workstation that is not logged on is rerouted to 
the console. No other messages are rerouted. 

If the system does not have workstations or DDP, messages go to the system 
console. 
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Function 



Identifies the job and indicates the beginning of control information for the job. 
The associated job's $Y$RUN file is given the same name. 



Format 



//[symbol] JOB jobname 



C,min],max] 



,r tasks 1 ,r max-time 1 

ill t jsup I 



C, print-option- I ist]C,acct-no]C,nXm3 



,r NOHDR 1 

\m J 



ACT 
LOG 

NQACT 

NOLOG 

NONE 

BOTH 



Parameters 

jobname 

One to eight alphanumeric characters specifying the job identifier. This 
name must be used to reference the control stream after it has been filed in 
$Y$JCS. 

Note: Do not hyphenate jobname if you plan to save the job. The save 
processor does not allow or recognize hyphens. 



o 



Preemptive job selection priority. If specified on a system that does not 
support roll in/roll out, the priority is converted to high (H). 



High job selection priority. 



Normal job selection priority. 



Low job selection priority. 
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min 



O 



Miniinum number of main storage b3rtes required to execute the largest 
job step of the job; may be specified in hexadecimal (by coding the 
number or Xnumher^ or in decimal (by coding jDViumfcerO. If the number 
is not preceded by an X or a D and enclosed in single quotes, it is 
considered hexadecimal. 2000 hexadecimal (8K decimal) is the 
minimum amount that can be assigned; it does not include the job 
prologue. The min parameter is required when the programs being 
executed are not in $Y$LOD, in an alternate load library on SYSRES, or 
on the volume containing the job's $Y$RUN file. 

Note: If you are compiling (or assembling), link-editing, and executing 
your program in a single run, job control cannot determine how 
much main storage is required for the execution of your program. 
If your generated load module requires more main storage than 
the compiler (the largest known job step), insufficient main 
storage will be allocated. If possible, you should indicate how 
much main storage is needed for your load module. 

max 

Maximum number of main storage bytes requested, but not required, to 
execute the largest job step on the job. May be specified in hexadecimal 
(by coding the number or X'number^ or in decimal (by coding 
D*number^, If the number is not preceded by an X or a D and enclosed in 
single quotes, it is considered hexadecimal. 

If either min or max is omitted, the value specified for one is assumed for the 
other. Only that space actually needed by the largest program in the job is 
specified. Job control adds additional storage for the prologue, as required. 

If both min and max are omitted, the length of the largest load module 
needed by the job is used. In most cases, omitting min and max gives the 
best use of main storage. Exceptions are programs that use additional main 
storage to improve performance (such as sort/merge), those cases where the 
user loads phases to locations other than addresses assigned by the linkage 
editor, or when programs to be executed are not on the SYSRES volume or 
the volume containing the job's $Y$RUN file at run time. 

tasks 

Maximum number of tasks that can be active simultaneously in any job 
step. Each task specified requires 256 bytes in the job prologue so tiiat 
the maximum number of tasks you can specify is limited by the size of 
the prologue (65,535 bytes). 
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max- time 

Maximum number of minutes this job should take for execution. 

Umax-time is omitted, the default value specified at system generation 
(SYSGEN) time is used. If your job executes beyond this limit (specified 
or default), the operator is queried as to whether the job should continue 
or be terminated. 

If a timer service is not specified at SYSGEN time, the job continues 
processing until normal or abnormal termination occurs, whether or not 
max-time is specified in job control. 

The specified max-time limit is adjusted to allow for the following 
conditions: checkpoint/restart, PAUSE job control statements, SET 
CLOCK commands, and roll out/roll in. 



SUP 



Suppresses the m^ix-time function completely for a particular job. 



print -opt Ion- list 

A list of one or more options used to control the printing of job control 
statements on the job log (in a spooling environment) or their display on 
the system console (in a nonspooling environment). 



BASIC 



PROC Expanded procs 

EMB Embedded data 

DEBUG Job control statements before substitution 

SKIP Statements skipped as a result of an IP or a GO 

directive 

WARNING Job control warning messages are not displayed on 

the console or workstation 

ALL All options in effect except WARNING 

H No options in effect (This is the defaidt in a 

nonspooling system.) 

Only the first character needs to be specified for each option. BASIC (B) 
is automatically in effect whenever P, E, D, or S is chosen. 

If more than one option is given, they must be separated by commas and 
enclosed in parentheses. 



N 



Basic job control statements with substitution ( ) 

(This is the default in a spooling system.) — ^ 
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acct*no 

Job accoiuit number of from one to four alphanumeric characters long. 

nXm 

Buflfer pool size. Job log and spooled files not having reserved buffers use 
this pool. 

n 

Number of buflfers. 

X 

Constant. 

m 

The number of 256-byte blocks per buffer. The only values accepted for m 
are 1, 2, 4, 8, 16, and 32. Numbers larger than 32 default to 32; numbers 
outside the acceptable range are changed to the lower acceptable 
constant (e.g., 6 is changed to 4). 

If omitted, one 256-byte buffer is assumed if only job log is used. If other files 
are also sharing the pool, two buffers (2x2) are assumed. 

ACT 

Forces the printing of accounting records, regardless of what system options 
are in effect. 

LOG 

Forces the printing of job log records, regardless of what system options are 
in effect. File catalog passwords do not appear in the job log file. 

NOACT 

Suppresses the printing of accounting records from the job log file. 

NOLOG 

Suppresses the printing of log information from the job log file (including 
main storage dumps). 

NONE 

Suppresses the printing of both accounting records and log information from 
the job log file. 
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BOTH 

Allows the printing of accounting records and job log information. 

NOHDR 

Suppresses the printing of page headers in burst mode. 

HDR 

Allows page headers to be printed. 

Note: The user should consult the parameters used for system generation to ensure 
that a conflict does not arise when submitting these parameters. 



c 
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Used to declare a local set symbol (local set symbols can be declared and 
referenced only within a jproc) or to change the value of a global set symbol 
without changing its status to local. 

Format 

//symbol JSET value 

Label 

symbol 

Set symbol name. 

Parameter 

value 

Value assigned to the symbol. May be a character string enclosed within 
apostrophes if it contains embedded blanks, may be a 2-term expression that 
is evaluated and converted to a character string before it is assigned, or may 
be used to establish a null character (blank). The operators allowed are +, -, 
*, /, ++, - 1 I -, **, and //. Leading zeros are maintained for multiple-digit 
numeric values in a JSET job control statement. If a leading zero is required 
when a symbol is used, it must be created by another JSET statement. 

Notes: 

1. When using a JSET statement to perform an operation, the operands to 
be acted upon must be numeric. 

2, When specifying a quoted value with 1 1 JSET, one level of quotes is 
always removed from the value, (For example, if I IX JSET 'ABC\ then 
&XisABC.) 
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Function 



Supplies label information for files on disk, diskette, or tape volumes for use by 
data management. There may be only one LBL statement in a device assignment 
set. 



Format 



//[symbol] LBL 



{file-identifier 1 ,{ file 
•file- identifier* J \ VCHEI 



••serial' 
VCHECK 



number 



[, expiration-date] 



[, creation-date] 



J file- 



sequence -number 



}■{ 



gener at i on • number 



1 



vers ion -number 



Parameters 



file- identifier 

Name that identifies the file; maximum of 17 characters for tape and data- 
set-label diskette files and 44 for format-label diskette and disk files, unless 
the disk files are temporary job or job step (scratch) files. In this case, the 
file-identifier can be fi'om 1 to 39 characters long. This name corresponds to 
the file label. If prefixed by $SCR, the file is temporary and deleted at the 
completion of the job step. If prefbced by $JOB, the file is temporary and 
deleted at the completion of the job. If prefixed by $LOKim (for disk files), 
the file is lockable. 
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•file- identifier' 

Name that contains embedded blanks. 

file- serial -number 

One to six alphanumeric characters specifying the file serial number. 
Identical to the volume serial number of the first volume of the file or 
diskette. 



VCHECIC 



A file serial number is to be created on output and checked on input. 
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If positional parameter 2 is omitted, the tape does not have a VOLl label, or 
there is no volume serial number/file serial number relationship for disk. 

expi rat ion -date 

File expiration date; may take either of two forms: 

• yyddd 

yy 

Is the year. 

ddd 

Is the day of the year. 

• RckWd 



Indicates that the file is to be retained. 

dddd 

Is the number of days (1-9999) that the output file is to be saved 
beyond the creation date. 

If you omit the expiration date and allocate then write to the file (in the same job 
step), the current system date is used. If omitted and the file is only being 
allocated, no date is specified and zeros are inserted. 

creation -date 

File creation date; written in the form, yyddd: 

yy 

Is the year, 

ddd 

Is the day of the year. 

If the creation-date is omitted for a tape file, the date stored in either the job 
prologue or the system information block is used. For a disk output file, the date 
stored in the job prologue is used; for a disk input file, the field is ignored. 

f i I e- sequence -number 

At file creation, assigns a sequence number to the file indicating its position 
with respect to the first file within a multifile set; should be specified in 
subsequent// LBL statements to indicate the file's position. If omitted on 
output, data management assigns 1 as the sequence number regardless of 
the file's position. If omitted on input, data management does not check for 
sequence numbers but expects to use the first file encountered. This 
parameter applies only to standard labeled tape files. 
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generation-number 

Unique edition of a file; applies only to tape files. 

version-nunber 

Version of a generation of a file; applies only to tape files. 
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LBL 

File Catalog 



Function 



Provides information for cataloging files. Allows for the maintenance of multiple 
generations of a file and protects against unauthorized access or update by using 
read/write passwords. Only disk and tape files may be cataloged. 



Format 



o 



//[symbol] LBL [qual/] level- id- 1 



, level - id-2- . . C , level - id-n] 



C(rpw/wpw)] 



'[quel/] level- id- 1 



, level ■ id-2- . . C , level - id-n] 



C(rpw/wpw)]« 



,r file-serial -number "I 
I VCHECIC J 



[, expiration-date] [, creation-date] 



-sequence-number 



J file 



, r version-nunber 1 



}1 



generation -number 



Parameters 



[qual/] level- id- 1 



, level- id-2... C, level -id-n] 



-n 



C(rpu/upw)] 



C 



Specifies the file catalog information; limited to 17 characters for tape files 
and 44 characters for disk files. If the level names include blanks, the 
parameter must have leading and trailing apostrophes. 
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qual/ 

File qualifier of from one to eight characters long. This removes a file from 
general use and places it in the category of restricted use. The slash is coded 
as part of the qualifier. 

level- id- 1 through level -id-n 

Level names for the file; each level must be separated by a period. 



Absolute reference number of a file generation. 

Creation number of a new file generation; the plus sign must be coded. 



■n 



Relative reference number of an old member of a generation in relation to 
the current member. The minus sign must be coded. 

(rpw/wpw) 

Read and write passwords of firom one to six alphanumeric characters long; 
must be separated by a slash and enclosed in parentheses. 

file- serial -number 

One to six alphanumeric characters specifying the file serial number. 
Identical to the volume serial number of the first volume of the file. 

VCHECK 

The volume serial number/file serial nimiber relationship is to be checked on 
input and created on output by data management. 

If positional parameter 2 is omitted, the tape does not have a VOLl label, or 
there is no volume serial number/file serial number relationship for disk. 

expi rat ion -date 

File expiration date; may take either of two forms 

• yyddd 

yy 

Is the year. 

ddd 

Is the day of the year. 

• Rdddd 



Indicates that the file is to be retained. 
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dddd 

Is the number of days (1-9999) that the output file is to be saved 
beyond the creation date. 

If you omit the expiration-date and allocate then write to the file (in the 
same job step), the current system date is used. If omitted and the file is only 
allocated, no date is specified and zeros are inserted. 

creation- date 

File creation date; written in the form, yyddd 

yy 

Is the year. 

ddd 

Is the day of the year. 

If creation-date is omitted for a tape file, the date stored in either the job 
prologue or the system information block is used. For a disk output file, the 
date stored in the job prologue is used; for a disk input file, the field is 
ignored. 

file- sequence - number 

At file creation time, assigns a sequence number to the file indicating its 
position with respect to the first file within a multifile set; should be 
specified in subsequent// LBL statements to indicate the file's position. If 
omitted on output, data management assigns 1 as the sequence number 
regardless of the file's position. If omitted on input, data management does 
not check for sequence numbers but expects to use the first file encountered. 
This parameter applies only to standard labeled tape files. 

generation -number 

Unique edition of a file; applies only to tape files. 

vers ion -number 

Version of a generation of a file; applies only to tape files. 
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Notes: 

i. The logical unit number specified on the DVC control statement when a file is 
cataloged must not be of the general type (50-59). This ensures that cataloged files 
will obtain a valid device whether or not the required volume is mounted when the 
job is scheduled. 

2. The plus and minus are only used to delimit relative generation references. Using 
it elsewhere results in errors. 

3. When cataloging a new member to a generation that will cause the maximum 
number of generations to be exceeded, the device type and volume serial number 
will be taken from the catalog entry for the oldest member of the generation. The 
oldest member is also automatically decataloged. This allows for the cycling of 
three tapes for the three current generations. 
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Function 

Overrides the system default load code buffer for a print file; becomes effective 
when the file is opened. During inteijob-step processing, the SYSGEN default 
value is used. If used, the LCB control statement must be within the DVC-LFD 
sequence for the print file that uses it. 

Format L- (SDMA and AP9215-1 Printers) 



//[symbol] LCB,C,CARTNAME=syinbol] 



, NAMES 



48-BUS 
48-SCI 
63-STD 
0WNLC1-0UNLC9 



C,TYPE= SDMA] 



,MISM=r IGNORE 1 
I REPORT I 



Format 2: (Non-SDMA Printers) 



o 



//[symbol] LCB 



r X'hex-string-1' 1 
[ C»char-string-V j 



,r X«hex-string-2' l,...,r X'hex-string-n' 1 
[ C'char-string-2' J \ C»char-string-n«| 



C,CARINAME=symbol] 



,NAME= 



AS-BUS 
48-SCI 
63-STD 
0UNLC1-0WNLC2 



. CART I pi 



[. NUMBC HAR=n3 



,TYPE=r * ] 
{ 0770 
I 0776 J 



,DUAL= 



X • xxyyxxyyxxyyxxyy • 
C'abababab' 

Xlyyyyyyyyi 

C*bbbb> 



,SPACE=| X»aa» 
C«c» 



«r X'aa'l 

tc-c I 



,MISM:::r illlQlii 



{ mm 1 

I REPORT J 



,MISMCHAR:: 



X'aa* 

C'c' 

X?40> 
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Label ,^ 

symbol 

Specifies a default cartridge or band name when CARTNAME is omitted or 
specifies the name of a filed load code buffer (48-BUS, 48-SCI, 63-STD, 
OWNLCn) that you're changing via the job SG$PRB. 

Parametera 

f X»hex-string« 1 

I C'char-stn'nfl' J 

For non-SDMA 0770/0776 printers, this is the actual load code buffer on the 
cartridge for which this load code is being constructed. You need two 
hexadecimal characters or one EBCDIC character for eveiy graphic symbol 
on the print cartridge. The position of each in the string of positional 
parameters corresponds to its position on the print cartridge. As many 
positional parameters as are needed to specify the entire print cartridge may 
be used by mixing the character and hexadecimal types, as required. 

For the 9246 printers, this is a 256-byte translate table that designates the 
character to print for each of the EBCDIC values from 00 to FF, 

This parameter is not applicable to SDMA printers. 

Note: Statement continuation may be used only between parameters. A particular 
parameter may not be partially coded on one statement line and continued on 
another. In hexadecimal representation, the number of digits must be even. 

CARTHA HE=svwbol 

1- to 8-character identifier of the print cartridge that the operator must mount. 
If specified, the system issues a mount message to the operator. If omitted, the 
user must take steps to stop the execution of the program, if necessary, to allow 
the operator to mount a required cartridge. You may use symbol instead of 
CARTNAME to specify a cartridge name. If you use both symbol and 
CARTNAME to specify a cartridge name, CARTNAME takes precedence. 

NAMES r 48- BUS 
48- SCI 
63-STD 
DUNLCn 

Specifies the name of a filed load code buffer, which in turn specifies a 
cartridge name. When NAME is specified, CARTNAME is unnecessary. 
When the job SG$PRB is being used to change a filed buffer, specify the 
buffer name using symbol instead of NAME. 

CARTIDsJ X'ae' 1 
ICC I 
Load code buffer cartridge or translate table identification. May be two 
hexadecimal digits (Xaa') or one EBCDIC character (C'c*). This parameter is 
required for the non-SDMA printers. 
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MUMBC HAR=n 

For non-SDMA printers only. Total number of grapliic qmibols expected on 
the print cartridge. Should coincide with the number of characters specified 
in the positional parameters as a safety check. 

If omitted, the number of characters specified by the positional parameters is 
assumed to be correct. 



TYPE=SDHA (format 1) or TYPE* 



8776 



(format 2) 



TVpe of Unisys print device. SDMA is used for printers attached to a system 
via a paper periphercd controller, and by model 7E users when specifying an 
AP9215-1 printer. The 0770 and non-SDMA 0776 printers are available only 
on the models 8/10/15/20/50 systems. For all other printers (*), TYPE must 
be specified by the logical unit number. 

Note: There are two types of 0776 printers: SDMA and non-SDMA Only the 
models 8/10/15/20/50 can accommodate a non-SDMA 0776 printer. 



SPACE= 



X'aa* 

mm 

C'c' 



o 



MISM 



For non-SDMA printers only. Blank character representation. May be two 
hexadecimal digits (X'aaO or one EBCDIC character (C'c*). 

\ REPORT J 

Specifies whether character mismatch error conditions are to be reported on 
the system log device. A mismatch occurs when you try to print a character 
that has not been placed in the printer's load code buffer or specified as a 
dualed character. 



DUAL=r X'xxyyxxyyxxyyxxyy* 
C*ab8bab> 
C'bbto' 
X'yyyvyyyy* 

For the 0770 and 0776 printers only. Allows you to equate up to four 
nonprintable character codes with up to four printable characters. This 
enables you to print data with up to 52 character codes using a 48-character 
print band. 
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For the 0770 or non-SDMA 0776 printer subsystems, you can choose the 
replacement symbol. If you specify in hexadecimal, you would choose the 
DC7AL= X,xxyyxxyyx:^xxyy' parameter option; xr is a specified character in 
the load code buffer and yy is a code that is not in the buffer; xx and yy print 
as the same graphic symbol. If you specify in EBCDIC, you would use the 
DUAL^C'abababab'parameteT option, a being a specified character 
representing a specific graphic symbol on the print cartridge and b being the 
character that is printed as the same graphic symbol as a. You may specify 
from one to four diaracter substitutions. 

MISMCHAR- X-aa* 
C«c» 
X'40« 

For non-SDMA printers only. The character specified through this 
parameter is printed for any character detected as a mismatch (a character 
that is not in the load code buffer and is not dualized). The character 
specified through the MISMCHAR parameter must be specified as a graphic 
symbol through positional parameter 1. 

Note: Only the first five characters of the LCB control statement's keywords needs 
to be specified (Le., CARTN^symbol, rather than CARTNAME:^mbol). If 
the keyword symbol has less than five characters, you have to specify them 
all. 
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LFD 



Fuiictioii 



Links the file information in the control stream with the data management file 
definition. For each LFD statement in the control stream, a file control block is 
generated that contains information determined as a result of processing device 
assignment sets. 

A device assignment set consists of at least one DVC statement and one LFD 
statement for each file to be accessed in the user program, and the LFD 
statement must follow the DVC statement. Depending on the file definition 
requirements, a device assignment set may also include VOL, EXT, and LBL 
statements inserted, in that order, between the DVC and LFD statements. 



Format 



//[synteU LFDT filenaine 
"lename 



Df filenaine 1 t f " 1 
\ *filename J | 1 J 



EXTEND 
IGNORE 

INIT 
PREP 
ID 



O 



Parameters 

filename 

One to eight alphanumeric characters specifying the logical file name; must 
be the same as the name specified in the label field of the DTF 
macroinstruction for data management or the PIOCB macroinstruction for 
the physical I/O users. 

*f i lenantelnput-only file. The operator should verify that the write enable ring has 
been removed fi-om the tape reel or that the file protect ON/OFF switch has 
been pressed to the ON position for the disk pack. 



o 



Maximum number of extents (up to 20) in the file; used to reserve extent 
table storage for use by data access methods. Space acquired by using this 
parameter increases the total storage requirement for the job and must be 
taken into consideration when allocating main storage, but not when 
specifying main storage space on the JOB control statement. This number is 
the s\xm of the physical extents on the disk plus the number of partitions in 
the file. 
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EXTEND 

Tape file is to be extended . The information is appended to the present end 
of the file, provided yoixr program makes the proper specifications. 

IGNORE 

Specified file is to be treated as an optional file. Allows you to decide at 
execution time whether accesses to the file should be processed or ignored 
based on the file resources that are available without having to change the 
program. 

Notes: 

1. This parameter is intended for use with consolidated data management 
only. It is ignored if specified for a file that is accessed by basic data 
management SAT files are also ignored. 

2. When IGNORE is specified, the following status is returned to the 
executing program: 

• File initialization (OPEN) - successful status 

• Input operation - end-of-file (EOF) indication 

• All other operations - successful status (request is ignored) 

3. When IGNORE is specified for an input file, the program should be 
performing sequential retrieval because it may not be expecting an EOF 
indication. 



O' 



INIT 



Specified file is to be initialized starting at the first record the first time the 
file is opened. Previous control information in the format labels is ignored at 
the file open time and is overwritten by specifications contained in this 
DVC-LPD sequence at file close time. This parameter should not be used for 
a checkpoint record file. 



PREP 



Specifies that a cataloged tape file be propped before it is used as an output 
file. 

ID 

One to ten characters that specify the owner's name. This information is 
stored in DL$ONR in the VOLl id field. 
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Function 

Positions tape volumes prior to the execution of a job step. Can be used to 
position a data file or pre-position a multifile tape volume. 

Must be specified after the device assignment set for that magnetic tape unit. 

Format 



//[symbol] HTC Lfdname, 



BB,nn 

BM.rm 

FB,nn 

FM,nn 

WMf nn 

RL 

RU 



Parameters 



o 



Ifdname 

The name of a tape file that is identified in a preceding DVC-LFD control 
statement sequence. 



BB 



Space volume backward the specified number of blocks. 



BH 



FB 



FM 



UM 



RL 



Space volume backward the specified number of tape marks. 



Space volume forward the specified number of blocks. 



Space volume forward the specified number of tape marks. 



Write number of tape marks specified. 



Rewind volume to load point. 
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NOP 

Function 

Inserts labels to be used as targets of branch or SKIP statements. 
Format 

//[symbol] NOP [QUERY] 
Parameter 

QUERY 

Used as the target of a dynamic SKIP function, which is accomplished 
through the // OPTION QUERY job control statement. This parameter is for 
workstation users and console operators. 

Note: Comments preceded by one or more blanks and enclosed in single quotes may be 
specified in the NOP statement in place of the QUEBY parameter. When used 
for this purpose, NOP does not have to be the target of branch or SKIP job 
control statements. 
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OPR 

Function 



o 



Displays a message at the system console or specific workstations. The statement 
can appear anywhere in the control stream and is displayed at interstep 
processing time. 

Format 

//[symbol] OPR coiiment-line [,destination-1,...,clestination-n] 

Parameters 

comnent-line 

Comment or message to be displayed; may contain up to 60 characters and 
must be enclosed in single quotes if it contains embedded blanks, the slash 
character, or commas. 

destination (where desti nations [host- id: }user- id) 

user- id 

Directs the message to a particular workstation; can be any 1- to 6- 
alphanumeric character workstation user-id, the keyword OPERATOR 
or $Y$CON (denoting the console), or $Y$MAS (denoting the job's 
master workstation). $Y$MAS is the default. 

host- id 

In a DDP environment, directs the message to a particular host; is one 
to four alphanumeric characters long and is identical to the label-id of 
the LOCAP macroinstruction in your ICAM network. You can specify 
$HOST to indicate the originator/master host. The host-id is optional 
but, if specified, must be followed by a user-id. If a host-id is omitted, 
the local host is assumed. 

If you omit a destination, the message goes to the master workstation. A message 
sent to a master workstation that is not logged on is rerouted to the console. No 
other messages are rerouted. 

If the system does not have workstations or a DDP, the message goes to the 
system console. 



o 
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OPTION 

OPTION ^-^ 

Function 

Specifies certain optional features and controls the operating environment. Some 
options are efTective only in the job step in which they are specified; others are 
effective from the time tiie option is encountered until end of job; while others are 
in effect for the entire job. The options may be written in any order and must be 
separated by commas with no intervening spaces. Only the first three characters 
of each option need to be coded. 

Format 

//CsymboU OPTION pU,...,pn3 

Parameters 

p1[,...,pn] 

Represents the options to be specified: 

ACN=account - number 

Overrides the acct-no specified in the JOB control statement. 



ABRDUMP 

Pi 

storage vicinity relative to the current TCB PSW and OPEN DTFs. 

BOF 



Provides abbreviated dump-only printing of selected areas in the macro f^ 



User program is given control with binary overflow intemipt-enabled. 

BUF=nXm 

Overrides the nXm parameter specified in the JOB control statement. 

DOF 

User program is given control with decimal overflow intemipt-enabled. 

DUHP 

Job region dump is provided in hexadecimal at job execution time if job 
step termination is requested, or snapshot dumps are given in response 
to a SNAP macroinstruction execution. 

E0D=xx 

Supplies substitute characters for the /* (end-of-embedded-data) job 
control statement. Used when embedded data is dialog specification 
language source code. The first character specified must be a slash (/). 
The second character can be anything but a slash, an asterisk, an 
ampersand, or a currency symbol (/, *, &, $). 
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GABRDUMP 

Specifies that OPTION ABRDUMP is in effect for every job step from 
the time GABRDUMP is encountered to end-of-job. 

GDUMP 

Specifies that OPTION DXJMP is in effect for every job step from the 
time GDUMP is encountered to end-of-job. 

GJOBDUMP 

Specifies that OPTION JOBDUMP is in effect only for the job step. 

GO 

Root phase of the last load module generated during the linkage editor 
job step is automatically executed at the completion of the linkage 
editor without intervention from job control. 

GSUB 

Provides symbol substitution for all embedded data sets in the job 
stream. This is a global SUB option. 

GSYSDUMP 

Specifies that OPTION SYSDUMP is in effect for eveiy job step from 
the time GSYSDUMP is encountered to end-of-job. 

HDRsJ NOHDR 1 
\ HDR J 

NOHDR suppresses the printing of page separators. HDR allows page 
separators to be printed. OPTION HDR overrides page separator 
specifications in the JOB control statement. 

HOLD 

Places a job containing it in hold status while the job is in the job queue 
table. A job containing this option is not released until a BEGIN 
operator command is issued or until a CO job control statement with BE 
specified is encountered in a subsequent control stream. // CC BE cannot 
be used to release a HOLD within the same job. 

JOBDUMP 

Provides an edited version of a dump if a dump is requested and is in 
effect only for the job step that contains this option. 



LINK 



Linkage editor is automatically executed following the termination of 
the program named on the EXEC statement. This allows you to compile 
and link job steps with no intervention fi-om job control. 
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LOG=r logical -unit -number 
ORIGINATOR 
CENTRAL 

Directs the job log to a specific printer or magnetic tape. The keywords 
ORIGINATOR and CENTRAL apply only to printers. ORIGNATOR 
directs the log to the printer at the job's originator. (This includes an 
auxiliary workstation printer if the originator is a workstation.) 
CENTRAL directs the log to the local site's central printer. Only 
LOG=CENTRAL can be specified in RBP-initiated jobs. The default log 
destination for RBP is the originator. If the DVC statement for the 
output file indicates a specific printer device (e.g., DVC 24) OPTION 
LOG=24 should be specified so that the job log and the output file are 
directed to the same device. 

IMMOVE 

Prevents memory consolidation movable shuffle in this job step. 

MASTER=dest i nat i on (where destination=Chost-id:]user-id) 

Assigns the specified workstation (at the specified host) as the master - 
the workstation that has control of the job during execution. By default, 
the originator (see OPTION ORI) has control of the job unless you use 
this option. OPTION MAS becomes effective when tlie job name is 
entered in the job queue and remains in effect throughout job 
processing. Specify OPERATOR to designate the console as master. 
Specify a host-id to designate (a workstation at) a particular host. If 
host-id is omitted, the local host is assumed. When you specify a host-id, 
you must follow it with a user-id. This option in a saved translated 
control stream is effective when the stream is restored. 

MASTER=destination (EXEC)(where destinations' [host -id:] user -id) 

Functions the same as 'MASTER=destination but takes effect only when 
the job is in execution. The originator has control when the job is in the 
job queue. 

MAX=fnaximum-main-storage-size 

Overrides the max parameter specification in the JOB control 
statement. The max value is expressed in hexadecimal iMAX=number 
or MAX^^Cnumher^. To indicate that the value of max is to be 
interpreted as a decimal value, sgeciSy MAX^D'numher*, If a maximum 
value is specified more than once (via the // JOB statement or multiple 
// OPTION statements), the largest value is used. 

MERGE=N0 

Used to create a separate identifer for a job's log in the spool LOG file. 
By including this option, you can determine if your job log is present in 
the accumulated LOG file. 
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MI N=nn"m*muni-ma in- storage- size 

Overrides the min parameter specification in the JOB control 
statement. The min value is expressed in hexadecimal {MAX^^number or 
MAX=X'number'). To indicate that the value of mm is to be interpreted 
as a decimal value, specify MIN=D'number\ If a minimum value is 
specified more than once (via the // JOB statement or multiple 
// OPTION statements), the largest value is used. 



o 



MXT=qnaxi mum- time 

Overrides the maX'time parameter specified in the JOB control 
statement. The maximum time can be specified in minutes, or you can 
speciiy SUP or DEP. MXT=SUP suppresses the max-time function. 
MXT=DEF specifies that the system default is to be used for the 
max-time value. 

NODUMP 

No dumps are taken for this job step. This option turns off snap dumps, 
end-of-job-step dumps, and abnormal termination dumps. This is 
defined for compatibility purposes and should not be specified. Job 
control assumes this condition by default. 

NOSCHED 

Saves a job control stream in its expanded state in $Y$SAVE but does 
not schedule the job. See the description of SAVE option for information 
about subsequent runs of the job. 



NOSCHED:(alt-filename 



[ , ur i te * password] ) 



RES 
RUN 
vsn 

Saves the job in its expanded state (in an alternate MIRAM library) but 
does not schedule the job. 

alt- filename 

Used to specify a 1- to 44-character file identifier. 



Used to specify the volume containing the alternate file. RES 
identifies the SYSRES volume, RUN identifies the RUN pack, and 
vsn identifies the volume serial number of a disk pack or format- 
label diskette. If the file is cataloged, RES, RUN, or vsn overrides 
the volume indicated in the catalog. If the file is cataloged and 
RES, RUN, or vsn is omitted, the volume indicated in the catalog is 
used. If the file is not cataloged and you omit RES, RUN, or vsn, 
SYSRES is assumed. 
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write- password f 

Used to specify a 1- to 6-character write-password when the file is 
cataloged with a write-password; ignored if the file has no 
password. 

See the SAVE option for information about subsequent runs of the 
job. 

NSCAN 

Resets the SCAN facility. It should be used only within the embedded 
data of a job step for wUch SCAN has previously been specified. 
Subsequent job control statements normally removed by SCAN are not 
removed. The OPTION NSCAN statement itself is removed. When 
NSCAN is specified, SCAN cannot be used again in the same job step. 

NSRCH 

Specifies that only the library indicated by the EXEC control statement 
is to be searched. 

NSUB 

Resets the SUB facility. It should be used only within the embedded 
data of a job step for which both SUB and SCAN have previously been 
specified. Set symbols in embedded data are not substituted until 
another SUB is encountered. 

NULL 

Specifies a no-operation for the OPTION statement 

0FT«*n 

Tells the run processor to reserve space for an additional number (n) of 
files in the open file table. The n parameter must be in the range 1 
through 16 and must be preceded by a plus sign. 

OPLapr i n t • opt 1 on • 1 1 8 1 

Overrides print'Option-list specifications in the JOB control statement 
Any of the options available through tiie print-option-list parameter of 
the JOB control statement may be specified via OPTION OPL. 
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0RIGINAT0R=d8Stination (where destination=[host-id:]user-id) 

Assigns a workstation (at the specified host) as the originator. The 
workstation that physically initiates the job is considered the originator 
and subsequently has control of the job during processing unless this 
option is used. OPTION ORI takes effect (changes user-id) when it's 
encountered in the control stream. That is, the run processor 
immediately changes the user-id to the one specified by the ORI 
parameter. You have the option of specifying more than one OPTION 
ORI statement in the same job stream. In such cases, the last OPTION 
ORI statement encountered in the job stream designates the 
workstation that controls processing at execution time as the originator. 
Specify OPERATOR to designate the console as master. Specify a host- 
id to designate (a workstation at) a particular host. If host-id is omitted, 
the local host is assimied. When you specify a host-id, you must follow it 
with a user-id. This option in a saved translated control stream is 
effective when the stream is restored. 



OUT= 
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ORIGINATOR 

CENTRAL 

[host-id:3user-id 

Directs all job output (print files, punch files, and job logs) to the 
specified destination as follows: 

• ORIGINATOR 

Directs all printed output to the printer at the job's originator. 
Directs all punch output to the central punch at the job's originator. 

® CENTRAL 

Directs all print or pimch output to the local site's central 
printer/punch. 

® Chost-id:]user-id 

Directs all printed output to the specified destination and all punch 
output to the central punch at the specified host. 

The host-id is from one to four alphanumeric characters long and 
identical to the label-id of the LOCAP macroinstruction in your 
ICAM network. Use $HOST to indicate the job's originator. The 
local host is assumed if the host-id is omitted. The host-id is 
optional but, if specified, must be followed by a user-id. 

A 1- to 6-alphanumeric-character workstation user-id identifies an 
auxiliary workstation printer. The keyword CENTRAL in place of a 
user-id identifies the central printer. 
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This option is effective for all of the job's print and punch output but can 
be changed for individual print or punch files by specifying// ROUTE or 
// DST in the device assignment set for that file. 

PRI=switch-priority 

Establishes an overall task switching priority that can be changed for 
particular job steps by specifying a relative priority (e.g., +3 or -3) or an 
absolute priority (e.g. 3) on the EXEC statement. 
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PRO 



Allows procs in embedded data. 



PRT = ACT 

LOG 

NOACT 

NOLOG 

NONE 

BOTH 

Overrides the print option specified in the JOB control statement. 

ACT forces the printing of accoimting records. 

LOG forces the printing of job log records. 

NOACT suppresses the printing of accounting records. 

NOLOG suppresses the printing of the log file. 

NONE suppresses the printing of both accounting records and log 
information fi*om the log file. 

BOTH allows the printing of accounting records and job log 
information. 



PSYSDUHP 

Terminates the job immediately if abnormal termination occurs. 
SYSDUMP is executed as a separate job. This allows immediate 
rerunning of the terminated job. You can force SYSDYMP to initiate a 
new job when SYSDUMP is initiated by program error. 



QUERY 



Allows the interactive user to change control stream execution fi-om a 
workstation. The QUERY option is explained in the job control user 
guide for your system. 



REPEAT 



Currently executing program is automatically reinitialized upon 
termination until all embedded data files are exhausted. This gives you 
the ability to execute stacked assemblies or compilations without job 
control intervention. 
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SAVE 



Saves a job control stream in its expanded state in $Y$SAVE and 
schedules the job to be run. A copy of the control stream as it appears in 
$Y$RUN is stored in the system file $Y$SAVE. Subsequent runs of the 
job are initiated through the SC/SI workstation or ^stem console 
command, or through the CC {SC/SI) job control statement. Saving an 
expanded job control stream that has a number of jprocs eliminates the 
time-consuming chore of jproc expansion by the run processor on 
subsequent runs. Information about the SC/SI workstation/console 
command is found in the Job Control Programming Guide, 7004 4623. 



SAVE: (aLt*fUename 



1' [,write-passuord]) 



RES 
RUN 
vsn 



Functions the same as SAVE but saves the control stream in an 
' alternate MIRAM library. 



alt-file 

Used to specify a 1- to 44-character file identifier. 
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RES 
RUN 
vsn 



Used to specify the volume containing the alternate file: RES 
identifies the SYSRES volume, RUN identifies the RUN pack, and 
vsn identifies the volimie serial number of a disk pack or format- 
label diskette. If the file is cataloged, RES, RUN, or vsn overrides 
the volume indicated in the catalog. If the file is cataloged and 
RES, RUN, or vsn is omitted, the volume indicated in the catalog is 
used. If the file is not cataloged and you omit UBS, RUN, or vsn, 
SYSRES is assumed. 

write -password 

Used to specify a 1- to 6-character write-password when the file is 
cataloged with a write-password; ignored if the file has no 
password. 
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SCAN 

Acts upon and then removes selected control statements (CR, OPTION, 
GBL, GO, IF, JSET, and NOP) from the embedded data files. 

If omitted, only the terminators (FIN, END, /$, and /*) are detected. 

SERIALS r A 1 

Allows you to have a list of RU/RV commands which are to be run 
serially rather than conoarrently; i.e., the first job must terminate 
before the second job is run. The list of RU/RV commands following the 
option serial statement is referred to as the controller job. 

The controller job can contain any number of RU/RV statements as well 
as other JCL statements, excluding DVG-LFD sequences and EXEC 
statements. The only statements allowed after the last RU/RV 
statement are SKIP and OPR. 

If SERIAL=C and a job terminates abnormally, the controller is also 
terminated and the following message is displayed: 

JC61 CONTROLLER JOB JOBNAME TERMINATED ABNORMALLY 

SERIAL=A specifies that the controller is not to be terminated. The 
UPSI byte is set to ^80' so the controller can skip to the abnormal path. 

When the last job terminates normally, the following message is f ) 

displayed: ^— ^ 

JC60 CONTROLLER JOB JOBNAME TERMINATED NORMALLY 

Multiple controllers can be active simultaneously. 

If you delete (DE) any job in the list, the entire process is terminated. 



SEVERE 

specifies that the run processor is to be terminated (the job is not to be 
scheduled) if warning errors are encountered. Normally, warning errors 
would not terminate the job. 

SI6 

User program is given control with fioating-point significant exception 
interrupt-enabled. 

SUB 

Scans embedded data for possible parameter or set symbol substitution. 

SYSDUMP 

Fully edited system dump provided if job step termination is requested. 
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TEST 

Specifies that the job is not to be queued or run. 

TRACE 

Brings in the monitor routine to record the effect of each executed 
instruction. Option monitor tasks are selected as described in the 
supervisor user guide. 

TSK=niniber - of - tasks 

Overrides the tasks parameter specified in the JOB control statement. 
From 1 to 255 tasks can be active within any job step. 

UNDEFINED 

Specifies that from the time this option is encountered to the end of job, 
a warning error message is to be generated whenever an undefined set 
symbol is detected. 

UNEQUAL 

Specifies that a warning error message is to be generated whenever two 
unequal character strings are compared. 

XUF 

User program is given control with exponent underflow exception 
interrupt-enabled. 



Note: 



The OPTION job control statement should not be placed between these job control 
statements: 

• EXEC and /$ 

• EXEC and PARAM 

• PARAM and PARAM 

• /* and /$ (where they delimit two separate embedded data sets) 
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PARAM 

Function 



Used to submit infonnation to the program during its execution. The information 
can be in the form of keyword parameters, control statements (other than job 
control statements), or any other type of information the program wants it to be. 
The changes are coded in the operand field. Job control verifies the format. 

PASAM statements must follow the EXEC control statement. Therefore, control 
belongs to the program named in the EXEC control statement, not to job control. 

There is no limit to the number of PARAM control statements allowed in a 
control stream. 

Format 

//[symbol] PARAM operand- 1 [,..., operand-n] 
Parameter 

operand 

Contains the information that is passed to the requesting program. If the x^'^'N 

information contains embedded blanks, it must be enclosed with single { ) 

quotation marks. V^ 
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Function 
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Displays a message at the system console or specific workstations but also causes 
the processing of the job to come to a halt until the message is acknowledged. The 
statement can be placed anywhere in the job step, but is not displayed at the 
system console or workstation until immediately before a program is executed. 

Format 

//[symbol] PAUSE comnent-line [, destination- 1,...,dest1nation-n] 

Parameter 

comment- line 

Comment or message to be displayed; may contain up to 60 characters and 
must be enclosed in single quotes if it contains embedded blanks, the slash 
character, or commas. 

destination (where destination=[host-id:]user-id) 
host- id 

In a DDP environment, directs the message to a particular host; is one 
to four alphanumeric characters and is identical to the label-id of the 
LOCAP macroinstruction in your ICAM network. You can specify 
$HOST to indicate the originator/master host. The host-id is optional 
but, if specified, must be followed by a user-id. If host-id is omitted, the 
local host is assumed. 

user- id 

Directs the message to a particular workstation; can be any 1- to 6- 
alphanumeric-character workstation user-id, the keyword OPERATOR 
or $Y$CON (denoting the console), or $Y$MAS (denoting the job's 
master workstation). $Y$MAS is the default. 

If you omit a destination, the message goes to the master workstation. A 
message sent to a master workstation that is not logged on is rerouted to the 
console. No other messages are rerouted. 

If the system does not have workstations or a DDP, the message goes to the 
system console. 

Note: The PAUSE statement suspends all job control activity for the control string in 
which it appears until the message is acknowledged, but the processing of other 
jobs in the system continues. 
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QGBL 

Function 



Allows you to change the value of global set symbols at run time from the 
workstation. 

Format 

//[symbol] QGBL set-1d-lC=init-1].,set-1d-2C=init-23,.-.,set-id-nC=init-n3. 
Parameter 

set- id- 1 through set-id-n 

Name of the set symbols; can be a maximum of eight characters in length. 

=init-l through =im"t-n 

Initial value of set symbols; can be a maximum of 60 characters in length. 

Note: Whenever a quoted value is assigned to a set symbol (using 1 1 QGBL), the 
quotes are considered paH of the value. (For example, if 1 1 QGBL X=ABC\ 
then &X is 'ABC unless changed,) 
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QUAL 

Function 



Prefixes an automatic qualifier to all svibsequent file identifiers in the job; 
remains in effect until the end of the job or until another QUAL job control 
statement is encountered. 

Format 

//[symbol] QUAL [qualname] 

Parameter 

qualr 



Qualifier of one to eight alphanumeric characters. 

If omitted, overrides the previous QUAL job control statement and terminates 
the use of a qualifier. 
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Function 

Permanently changes (renames) the label of a disk or format-label diskette file. 
Format 

//[symbol] REN IfdnameJ new- label 1 C,NTERM] 



i,r new- label l C,^ 
I 'new-label 'J 

Parameter 

Ifdname 

Identifies the file to be renamed. It must match the Ifdname in the LFD 
statement for the file. 

new- label 

Specifies the new name for the file; 1 to 44 alphanumeric characters in 
length. If new4abel contains embedded blanks, it must be enclosed by 
apostrophes. 

NTERM 

Specifies that errors encountered during the renaming process are to be 
ignored and the job allowed to continue. If this parameter is specified and a 
renaming error occurs, the job continues, but the file is not renamed. If this 
parameter is omitted and a renaming error occurs, the job terminates at the 
point of error. 

Notes: 

1. Subsequent references to a renamed disk file must specify new-label in the LBL 
statement of the device assignment set for the file, 

2. If you rename a cataloged file, you must recatalog the file with the new name. 

3. REN statements are not permitted against files on SYSRES that begin with $Y$ or 
against files on SYSRUN that begin with $Y$R. 
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ROUTE 

Function 



Specifies up to eight destinations for non-DDP destinations or one DDP site 
destination. These destinations are the central printer or punch at a local or DDP 
site, a workstation auxiliary printer at a DDP site, or an auxiliary printer that is 
locally or remotely connected to your system. 

Format 

//CsymboU ROUTE destination-1, - . . , destination -8 
Parameter 

destination (where destination=Chost-id:]user-id) 
CENTRAL or 0S3CTR 

Destination is the central printer or punch at the local site. 

host- id: CENTRAL 

Destination is the central printer or punch at the DDP site identified by 
the one to four character host-id, 

host-id:userM*d 

Destination is a DDP site (identified by the one to four character 
host-id) at which the printer output will be routed to an auxiliary 
workstation printer identified by the one to six character user-id. 

user- id 

Destination is an auxiliary printer on a workstation (identified by the 
one to six character user-id) that is locally or remotely connected to your 
system. 

$Y$MAS 

Destination is the auxiliary printer if the master at the local site is a 
workstation. Otherwise, the destination is the central printer at the 
local site. 

This destination is valid only for print files. 

Notes: 

1. Output can be routed to the site central printer and up to seven auxiliary printers, 

2. The 1 1 ROUTE and 1 1 DST statements cannot be mixed in the same job. 
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Examples 

// ROUTE 0S3CTR 

and 

// ROUTE CENTRAL 

route output to the central printer. 

// ROUTE USERID1, . . .,USERID8 

routes output to up to eight auxiliary printers. 

// ROUTE 0S3CTR,USERID1, . . .,USERID7 

routes output to the central printer and up to seven auxiliary printers. 

Notes: 

L DDP or auxiliary printer output (specified by 1 1 ROUTE) and RBP output 
(specified by 1 1 DST) cannot be mixed for any one job. For any job, all output 
must be of one type or the other. Also, DDP destinations and local auxiliary printer 
destinations cannot be used for the same print file. 

2. When a workstation or terminal initiates a job that directs printed output to an \^^^ 

auxiliary printer connected to a local or remote workstation or terminal (one that is 
not the originator), the user at the other workstation or terminal must be logged on 
with the same user-id as specified in the 1 1 ROUTE job control statement and 
must issue an RP command to initiate printing. See the Interactive Services 
Operating Guide, UP-9972, for more information on the RP command. 



o 
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RST 

Function 



Restarts a BAL or COBOL program from a checkpoint when a computer 
malfunction causes a job to terminate. Checkpoint records are established by the 
CHKPT macroinstruction (in BAL) or the RERUN clause (in COBOL). 

When the job is on cards, the RST statement must be the first card in the deck 
when the job is rerun. For a prefiled job, RST can be submitted from a card 
reader or added to the control stream (as the first statement) via the general 
editor (EDT) or the librarian. When the job is rerun, the program's execution 
begins at or near the checkpoint reached when the job stopped. 



Format 



o 



//[symbol] RST filename, checkpoint- id,step-nuniber , jobnameC(renane)] [,pri] 
C ,key- 1=val - 1 , . . - ,key-n=val -n] 

Parameter 

filename 

Name of the checkpoint file; must agree with the filename specified on the 
LFD statement for the checkpoint file. 

checkpoint- id 

Checkpoint number identifying which checkpoint is used to restart the job. 
This number is displayed on the system console when checkpoint records are 
encountered in the program. 

step- number 

Specifies the number of the job step that executes the user program to be 
restarted. 

jobname 

Names a prefiled job to be rerun when RST is submitted firom a card reader. 
Must be specified if the (rename) parameter is used to assign an alternate 
name to the prefiled job. 

(rename) 

Alternate name of the job. Executes a previously filed control stream and 
enables the use of different job names. 

pri 

Scheduling priority. 
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key-n=val-n 

A keyword and its value that may be referenced as would any GBL control 
statement. The effect of these parameters is as if a GBL control statement 
were inserted as the first control statement of the job. The total length of this 
parameter cannot exceed 44 characters. 

Notes: 

1. All information necessary to prepare an RST control statement is displayed at the 
system console each time a program encounters a checkpoint 

2. The LFDjob control statement in the device assignment set for the checkpoint file 
must not contain the INIT parameter. This parameter causes the file to be written 
from the beginning of the file, thus overwriting any existing records. 

3. In COBOL, the RERUN clause is equivalent to the checkpoint macroinstruction, 

4. The following must be taken into consideration when restarting a job: 

• Only one RST control statement may be submitted for any one job. 

• If the program being executed at the time the checkpoint is recorded is in the 
job's $Y$RUNfile (output of the linkage editor), the job to be restarted will not 
run to normal completion if a program overlay is called after the job has been 
restarted. 

• If a restart is to be done after the job has terminated (normally or 
abnormally), the restarted job step must not have originally had requests for 
temporary work areas. 

• Tapes previously positioned via an MTC control statement are not positioned 
to the proper point in the restarted job. 

• Card files cannot be repositioned. 

• If a multifile tape is to be repositioned, the file sequence number must be 
included on the LBLjob control statement. 

• The disk file containing checkpoint records cannot contain user data. 

• Scheduling may be delayed if all the resources needed by all job steps in the 
job are not available, even if those needed only by the job step to be restarted 
are available. 

• Mount messages to the operator may be produced for volumes that were not 
needed in the original run. This is due to the fact that SKIP control statements 
are ignored. 

• Workstation files cannot be repositioned; therefore, a job cannot be restarted 
from a checkpoint that occurs when workstation files are opened. 
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RUN/RV 



Function 



The RUN and RV statements permit another job to be initiated. RUN and RV 
control statements function in the same way, except that RUN should be used to 
call a control stream that is on cards or that is prefiled (in $Y$JCS or an alternate 
library) and contains a CR statement because input (from a card reader) is 
necessaiy. RV is only used to call prefiled control streams that do not require a 
card reader. If RUN is used when a card reader is not required, the job is not 
initiated until the (unnecessary) reader is available. If RV is used when a card 
reader is required, the job is not initiated. 

The RUN or RV statement may appear anywhere within the control stream, 
except between /$ and /* control statements or a critical series of control 
statements, such as the DVC through LFD sequence. 



Format 



//[symbol] 



O 



RUN 



jobnameC (new-name) 
(new-name) 



■} 



RV jobnameC (new-name)] 



:alt-fil 
:(alt-fil 



: (alt-filename. 



RES 
RUN 
vsn 

RES 
RUN 
vsn 



, read- password) 



PRE 
HIGH 
NOR 
LOU 



r time \ 
\ time+n J 



[ ,key- 1=val • 1 , , , - ,key-n=val -n] 



Parameters 



jobname[ (new-name)] 

One to eight alphanumeric characters identifying the job. A job name is 
required with RV, but can be omitted from RUN if the control stream is to be 
read from a card reader. The name used on the control stream's JOB 
statement is assigned in this case. 
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RUN/RV 



Include (new-name) to assign a new 1- to 8-£Llphanumeric character name 
identifying the selected job control stream. The job assixmes the new name, 
thus reducing the chance of duplicate job names. The new name alone may 
be used with RUN if the control stream is input from a card reader. 



c 



:alt-fil€ 

Specifies the name of the alternate SAT library file, residing on SYSRES, 
that contains the job control stream. If the file name is cataloged (without a 
read password), the volume associated with that file name in the catalog is 
used. 



(alt-fil 



RES 
RUN 
vsn 



) 



Specifies the name of the alternate SAT library file and the volume 
containing the file. RES identifies SYSRES as the volume, RUN identifies 
the system RUN pack, and vsn identifies the volume serial number of a disk 
pack or format-label diskette. If the file name is cataloged (without a read 
password), the volume you specify (JRES, RUN, or vsn) is used instead of the 
volume associated with the file name in the catalog. 



(alt- filename. 



RES 
RUN 
vsn 



, read- password) 



Specifies the name of the alternate SAT library file and the volume 
containing the file. The read-password parameter must be specified if the file 
name is in the file catalog with a read password. RES identifies SYSRES as 
the volume containing the file, RUN identifies the system RUN pack, and 
vsn identifies the volume serial number of a disk pack or format-label 
diskette. If RES, RUN, or vsn is omitted, the volume associated with the file 
name in the catalog is used. 

If no alternate file name is specified, the job control stream is read fi-om $Y$JCS. 

PRE 

Specifies preemptive priority for the job control stream. 



HIGH 



NOR 



LOU 



Specifies high priority for the job control stream. 



Specifies normal priority for the job control stream. 



Specifies low priority for the job control stream. 
If omitted, the priority specified in the control stream's JOB statement is used. 
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) 

time 

Is a 4-digit number speciiying a time of day in military format indicating 
when execution of the job is to begin. 

n 

Is an integer from 1 to 9 specifying the number of days after today to start 
execution of the job. 

If you use the time with the priority parameter, you must use the first letter of 
the priority parameter, not tiie whole word. (For example, H1230 is acceptable, 
HIGH1230isnot.) 

key- 1=val - 1 , . . . ,key-nsval -n 

A keyword and its value that may be referenced as would any GBL control 
statement. The effect of these parameters is as if a GBL control statement 
were inserted as the first control statement of the job. 

Note: The total length of the RUN and RV statements, from theRinRUNorRVto 
the last character of the last specified value, cannot exceed 60 characters. 
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SCR ^ 

Function 

Scratches (deletes) files. Any specified file is deleted immediately upon the 
detection of an SCR control statement. Therefore, files may be deleted prior to 
the execution of a given job step. Files to be scratched should not be in use by 
another job. Files with a label prefix of $Y$ cannot be deleted from the SYSRES 
volume. Only files on volumes currently mounted are deleted. Only one volume 
serial number may be specified for any SCR job control statement. The DATE and 
PRE parameters are not supported for diskette files. 



Format 



//[symbol] SCR Ifdname 



Parameters 



■( 



DATE,Cyyddd] 
PRE,Caaaa] 



Ifdname 

File name to be deleted; must agree with the file name given on a previous 
LFD statement in a DVC-LFD sequence. If positional parameter 2 is DATE 
or PRE, the LBL statement may be omitted from the DVC-LFD sequence. 

DATE ( J 

Delete all expired files from the volume. The expiration date, if different 
from the ciurent date, is specified in positional parameter 3. 

PRE 

All files on the volume with the prefix specified in positional parameter 3 are 
to be deleted. The first three characters of the prefix cannot be $Y$. 

If positional parameter 2 is omitted, the entire file specified by positional 
parameter 1 is deleted. Positional parameter 3 should also be omitted. 
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yyddd 

Date used in testing for expired files: 

yy 

Is the year. 

ddd 

Is the day of the year. 

Leading zeros must be specified. If the date is omitted, the current date from 
the job prologue is used. 

aaaa 

The 1- to 8-character prefix of files to be deleted. The first three characters of 
the prefix must not be $Y$. If omitted, the file identifier from the associated 
LBL job control statement is used. 
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Function 



Sets or modifies the date fields, the user program switch indicator (UPSI), the 
communications region in the job prologue, or the local data area in the job 
prologue. Support for the user local data area is primarily for compatibility with 
the IBM® System/34 LDA feature. It can be used as a larger communications 
region if so desired. The SET statement does not alter fields in the system 
information block (SIB); this must be done by the SET operator command. 



Format 



//[symbol] SET 



DATE,yy/mm/ddC , t-date] C ,d-date] 
UPSI, switch-setting 
COMREG, character -string 
LDA, n,n, character-string 



Parameters 



DATE 

Stores the contents of positional parameters 2, 3, and 4 in the job prologue 
date fields. These dates are to be used rather than the system date. The date 
change is temporary and remains in effect until the end of the job. 

yy/mm/dd 

Calendar date. 



o 



t-date 

5-digit date (yyddd) for a tape file: 



yy 



Is year. 



ddd 



Is day of the year. 



The date is right-justified in a 6-character field in the job preamble. The 
leftmost character is set to an EBCDIC blank. You may, however, indicate 
the quarter of the year in this position. 

If positional parameter 3 is omitted, the SIB date is used. 



IBM is a registered trademark of international Business Machines Corporation. 
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d-date 

5-digit date (yyddd) for a disk file: 

yy 

Is the year. 

ddd 

Is the day of the year. 

The date is converted to a 4-byte discontinuous binary format, Oydd. 

If positional parameter 4 is omitted, the positional parameter 3 value is 
used, if specified, or the SIB value is used if both positional parameters 3 
and 4 are omitted. 

UPSI 

Sets the UPSI byte in the job prologue according to the bit pattern of 
positional parameter 2. The UPSI byte is the last byte of the 12-byte 
communication region in the job preamble. 

switch -setting 

Switch setting (one to eight bits). The bit indicators are: 

Off 

1 On 

X Unchanged 

Unspecified rightmost positions are assumed to be X. The byte is initially set 
too. 

COMREG 

Stores the contents of positional parameter 2 in the job prologue 
communication region. 

Note: If UPSI and COMREG are not specified, the fields in the job prologue are 
set to binary zeros. 

character-string 

Stores 2 to 24 hexadecimal or 1 to 12 EBCDIC characters in the job preamble 
communications region. The data is lefl;-justified, and unspecified rightmost 
characters remain unchanged. Hexadecimal characters are designated 
X'ccccc...' and must be even in length. EBCDIC characters are designated 
C'ccccc...'. 
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Automatically sets the OPTION LDA which sets up the LDA in the job 
prologue. Also allows you to store character strings in the LDA. 



Specifies the byte at which the character string starts in the LDA. The 
lowest value for this parameter is 1. 



Specifies the total number of bytes occupied by the character string. Value 
must be equal to or greater than the length of the string. It cannot exceed the 
length of the LDA or be a value that in coi^unction with the n parameter 
specification extends beyond the end of the LDA. 

character -string 

Data stored in the LDA. The character string is stored left-justified. If it 
contains blanks, the character string must be enclosed in single quotes. 
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Function 



There are three applications for the SFT statement: 

• Identifying user- written shared code modules that reside in a libraiy not on 
SYSRESor$Y$RUN. 

• Identifying data management shared-code modules so that those modules 
are loaded before job initiation and stay resident for the duration of the job. 
Even though you do not need to identify data management modules to load 
them, if you do identify them through // SFT, they are loaded before job 
initiation. This ensin-es that your job does not have to wait for main storage 
space to be allocated for the data management modules. 

• Specifying the dynamic loading facility and/or overriding system generation 
Umits for dynamic expansion of the user job region. 



Format 



o 



//[symbol] SFT 



module- U , . . . ,module-n] 



,DL0AD= 



([calls]. 



[expansion- I imitl 

H J 



DLDAD= 



([calls]. 



Fexpansion- 1 imi t] 

|max J 



Parameters 

mockile 

Identifies the shared-code modules needed. 



DLOAD 



Tells the run processor that your job needs the OS/3 dynamic loading facility 
and/or that the job is to override the SYSGEN limits for expansion of the 
user job region. 



calls 



Specifies the maximum number of dynamically loaded modules allowed for 
this job; if omitted, the system default (as set by the SYSGEN parameter 
DLOADTABLE) applies. 
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expansion- 1 iin ft Vy" 

Specifies the maximum number of b3rtes (total) that can be added to this job 
in support of the DLOAD facility; considered hexadecimal if you specify 
X'number'; considered decimal if you specify D'number*. 



MAX 



Indicates that the size of the job is limited only by the amount of main 
storage in the system. 

If an expansion limit is omitted {expansion-limit or MAX are not specified), 
the ^stem default (as set by the SYSGEN parameter DLOADBUFR) 
applies. 

Note: Data managejnent shared-code load modules reside in the system 

library $Y$SCLOD. The SAT librarian is used to list the modules in 
$Y$SCLOD and to obtain information about them. 
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SKIP 



Function 



Bypasses desired portions of the control stream, either conditionally, based on 
UPSI bit settings, or unconditionally. This skip is effective at execution time, as 
opposed to the IF and GO control statements, where the skip occurs when the run 
processor scans the control stream prior to execution. The statements that are 
skipped are not acted on. The skip can only be in a forward direction. 



Format 



//[symbol 3 SKIP target- label 



,mask 



ALL 
ANY 
NONE 



Parameters 

target' label 

Corresponds to the label specified in the optional label field of another 
control statement. The label field may be on a NOP control statement. 



o 



mask 



Is a binary number used to test the UPSI byte (one to eight bits). Thus, the 
SKIP statement is conditional. If fewer than eight bits are specified, the 
unspecified rightmost positions are each assumed to be 0. 



ALL 



ANY 



The allowable characters in the mask are: 

Ignore the bit 

1 Test the corresponding UPSI bit to determine where it is set. 

If the mask parameter is omitted, the SKIP control statement is 
imconditional. 



States that all the UPSI bits indicated by the mask must be set to satisfy the 
skip condition. 



States that any UPSI bit indicated by the mask can be set to satisfy the skip 
condition. 



NONE 



States that no UPSI bit indicated by the mask needs to be set to satisfy the 
skip condition. 
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1, 



Function 



Controls output spooling. When used, SPL must occur within the DVC-LFD 
sequence for the file to be spooled. It is ignored in a nonspooling environment. 



Format 



//[symbol] SPL 



r 




r 1 


f HOLD 1 


CnXrn] 


,f no-cop 


RETAIN 




DISK 






TAPE 




t DISKETTE . 




L 







,r no-skpcode | 

17 / 



max-rec 



[, forms] 



, r NOHDR 1 ,r NOTSTL 1 
\WM J \ STL I 



C,brk-pge] 



,f NOUPD 1 
\ UPD f 



[,NOCMP][,RETAIN][,HOLD][, SECURE] 



Parameters 



HOLD 



Output file is to be held for later disposition. Can be released l^ a BEGIN 
SPL workstation/console command or through the CC job control statement 
specifying this command. 



RETAIN 



Output file is retained in the spool file after it is printed or punched; file may 
have to be reprinted or repunched at a later time. 



DISK 



Redirects the spooled output to another disk volume. 



TAPE 

Redirects the spooled output to a tape volume. 

DISKETTE 

Redirects the spooled output to a format-label diskette. 

Note: When using the SPL statement for a spooled data-set-label output file, only 
the nXm, NOUPD/ UPD, NOCMP, RETAIN, and HOLD parameters are 

meaningful 
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nXm 



Buffer size established for use by this file 

n 

Number of buffers. No advantage is gained by making n greater than 2, 
unless system symbionts are being used. 

X 

Is a constant. 

m 

Is the number of 256-byte blocks to be assigned to each buffer. 

If omitted, the file shares the buffer pool with the job log and other spooled 
files not having their own buffers. 



t no -cop 1 



Number of times the spooled file is to be printed or punched (output), in 
range of through 255. Zero indicates no oiitput. 

{no-skpcode \ 

Used when a filed vertical format buffer having more than seven skip codes 
is requested (via // VFB) or when the system default buffer has more than 
seven skip codes. Indicates the number of lines in the bu£Fer that contain 
skip codes, plus three (one for forms overflow and two for home paper 
position). Zero indicates no skip codes. 



mm 

e 

Mgiximum number of records (lines, including spaces and skipped lines fi-om 
print files, and cards for punch files) that can be placed in the spool file 
before the operator is queried as to whether the job should be continued or 
terminated. The largest number the max-rec parameter will accept is 
262144. Value specifies no limit is put on the number of records entered 
into the spool file. 

forms 

A 1- to 8-alphanumeric-character name identifying a special printer form or 
card type to the operator. 

NOHDR 

Suppresses the printing of page headers in burst mode. 
Allows page headers to be printed. 
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NOTSTl 

Suppresses the query to the operator questioning if a sample test pattern 
page is to be printed when a change of form name is detected. This query 
does not occur for STANDI forms. 

STL 

Sends a test Hnes message to the operator when a forms change is required. 
If STL and NOTSTL are omitted, the system default is used. 

brk-pge 

Indicates the specific number of pages or cards to be spooled out before a file 
is breakpointed and printed or punched. The largest number that can be 
entered in this parameter is 32,000. 

NOyPD 

Indicates that the spool subdirectory entry is to be updated only when a file 
is closed. If NOUPD is specified all program spool output is lost if the system 
goes down or hangs. Abnormal termination of a program does not result in 
lost spoolout. If omitted (causing the spooler to update the subdirectory entry 
each time it crosses a logical track in the program file) and the program 
cancels, output generated before cancellation can be printed. 



UPD 



Enables recovery of spooled data if the system crashes. 



NOCMP 

Prevents the system fi-om attempting to compress data that's directed to the 
output spool file. Normally, NOCMP should not be specified if data in the file 
contains a large number of embedded blanks or if the file contains a block 
size larger than 120. If specified when the block size is 121 or greater, the 
resulting spool file contains only one line per sector and requires that nXm 
be at least 2X4. 

RETAIN 

Functions the same as the first RETAIN parameter but is independent of the 
other first-parameter options. If specified with TAPE, DISK, or DISKETTE, 
the output is redirected to the appropriate device while a copy of the file is 
also retained for later use. 



HOLD 



Functions the same as the first HOLD parameter but is independent of the 
other first-parameter options. If specified with RETAIN; TAPE, DISK, or 
DISKETTE; or RETAIN and TAPE, DISK, or DISKETTE, the spool file is 
put on hold first. Other parameters are acted upon when the file is released. 

SECURE 

Suppresses printing of the output file if workstation to which the auxiliary 
printer is connected is not logged on. If not specified, the file is printed at the 
specified auxiliary printer whether or not the workstation is logged on. 
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UID 



Function 



Allows you to specify a workstation, including the system master workstation, by 
user-id, device address, or both. The workstation specified is required and, when 
logged on, is automatically connected to the job. Used as part of the device 
assignment set for a workstation. 



Format 



//[symbol ]UID 



user- id- 1 

(addr-1) 

user-id-Kaddr-l) 



u8er-id-255 

(addr-255) 

U8er-id-255(addr-255) 



Parameters 

user- id 

Specifies a workstation by user-id. You can use $Y$MAS as a user-id to 
identify the system master workstation. 
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(addr) 



Specifies the physical address of the device in hexadecimal; represents the 
channel number, control unit address, and the device number. 



o 



user- id(addr) 

Specifies a workstation by user-id and physical address. 
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USE DP ^ 

Function 

Specifies that the dialog processor is needed in support of a dialog session at the 
workstation. Used as part of the device assignment set for a workstation. 

Format 

//[symbol ]USE DP^dialog-nameC, printer- lfd][, new-audit-lfd]C, old-audit- Ifd] 
Parameters 



dialog- 

A 1- to 8-alphanumeric-character name of the dialog file; must match the 
name specified on the LFD statement of the dialog file's device assignment 
set. 

printer- If d 

A 1- to 8-alphanumeric-character name of the printer file; must match the 
name specified on the LFD statement of the printer's device assignment set. 
This parameter is specified when you want to produce a printed summary of 
the dialog session. 

ney-audit-lfd 

A 1- to 8-alphanumeric-character name of the new audit file produced by the 
dialog processor; must match the name specified on the LFD statement of 
the new audit file's device assignment set. 

old-audit- Ifd 

A 1- to 8-alphanumeric-character name of the old audit file input to the 
dialog processor; must match the name specified on the LFD statement of 
the old audit file's device assignment set. 

Note: Audit files must be previously allocated MIRAM files. 



O' 
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c 



USE LIB 



USE LIB 



Function 

Allows a user program to either sequentially read or write (create) a module. 

Format 



//[symbol] USE LIB, module -name 



,TYPE= 



Parameters 



c 



module-name 

A 1- to 8-alphanumeric-character name of the module to be accessed. The 
first character must be alphabetic. 



TYPE= 



Specifies the module type as either program source (S), macro/jproc source 
(M), object (O), or load (L). 
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USE MENU 



c^ 



Function 



Indicates that menu services are to be used at the workstation. Specified as part 
of the workstation device assignment set. 



Format 



//[symbol] USE MENU 



menu-f 1 le-LFD/|y$FHT 
iY*FHT/n)enu-file-LFD3 



[, initial -menu] 



,j™j 



I,menu-format-1=alias-1C,-.wn»enu-format-12=alias-12]] 



Parameters 



menu-f ile-LFD^af 
lY$FHT/menu-file-LFD 
. $y$FMT 



Specifies LED names for up to two menu format files; must match LED 
names used in previously defined device assignment sets for the files. The 
menu-file-LFD name is one to eight alphanumeric characters in length and 
must refer to a MIRAM file. 



menu-f ile-LFD/*Y$FHT 

Identifies two format files. The file identified by menu-file-LFD is 
examined first, then $Y$FMT. 



$Y$FMT/menu-file-LFD 

Identifies two format files. $Y$FMT is examined first, then the file 
identified by menu-file-LFD. 

If nothing is specified, it is assumed that all menu formats reside in the 
system format file $Y$FMT. 

initial -menu 

Specifies the name of the first menu to be used. It is one to eight 
alphanumeric characters in length. 



o 



Specifies the number of menus to be resident in main storage at any one 
time, in the range 1 to 255. The default value is 1. 



c 
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C 



USE SFS 



Function 



Specifies that screen fonnat services are needed in support of a screen format 
session at the workstation. Used as part of the device assignment set for a 
workstation. 



Format 



//Csymbol] USE SFS 



Cfonnat-ffle-LFD-1]/[fonnat-file-LFD-23 
fonnat -f lie- LFD 



C, initial -screen] 



, f nnn 1 



, screen-format- 1=alia8-lC,...,8creen-foniiat-12=alias- 12]. 



Parameters 



c 



^ 



c 



Cfopinat-file-LFD-1]/[format-file-LFD-2] 
format-file-LFD 



Specifies LFD names for up to two screen format files; must match LFD 
names used in previously defined device assignment sets for the screen 
format files. The format-file-LFD name is one to eight alphanumeric 
characters in length and must refer to a MIRAM file. 

[format-file-LFD- 1]/[format-file-LFD-2] 

Identifies two format-file-LFD names. If format-file-LFD- 1 is coded 
alone, format-file-LFD- 1 is examined first then $Y$FRCT. If Iformat- 
file-LFD-2 is coded alone, $Y$FMT is examined first Hienformat-file- 
LFD-2. 

format-file-LFD 

Identifies one format-file-LFD name. This is the only file examined. 

If nothing is specified, it is assumed that all screen formats reside in the 
system format file $Y$FMT. 
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O 



Initial -screen 

Specifies the name of a screen format to be used by the application program. 
It is one to eig^t alphanumeric characters in length. Use of this parameter 
depends on the program's language. For more information, see the Screen 
Format Services Technical Overview (UP-9977). 



Specifies the number of screens to be resident in main storage at any one 
time, in the range 1 to 255. The defaidt value is 1. 

screen-format=al ias 

Equates a screen format name specified in an application program (alias) to 
the screen format name generated by the screen format generator. A 
maximum of twelve alias name sets may be specified. The screen-format 
name and alias name may each be fix)m one to eight alphanumeric 
characters in length. 



o 
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VFB 



Function 



Overrides the system default vertical format buffer for a printer; becomes 
effective when the file is opened. During interstep-job processing, the SYSGEN 
default value is used. If used, the VFB directive must be within the DVC-LFD 
control statement sequence for the print file that uses it. 



Format 



o 



//[symbol] VFB [,FORMNAME=symboU 



,ysE= 



STANDI 
0WNVF1 
0WNVF2-0WNVF9 



[LENGTHS: lines 3 



,DENSITY=r 6 1 



,nPE= 


SOMA ] 




0770 




0776 




* 


. 


, 



(SOMA and AP9215-1 printers only) 
[,0yF=(line-1,-..,line-n)]C,0VF2=(line-l,...,linc-n)3 



, line-n)3 



[,CD1=(line-1,...,line-n),...[,CD15=(line-l, 
C,HP=n] 



Label 

syiftiol 

Specifies 1- to 8-character vertical format buffer name; used as the default form 
name when the FORMNAME parameter is omitted. 

Specifies a default form name when FORMNAME is omitted or specifies the 
name of a filed vertical format buffer (STANDI or OWNVFn) you're changing via 
thejobSG$PRB. 

Parameters 

FORMNAME^symbol 

Specifies a 1- to 8-character printer form name. This is the name that the 
operator associates with the actual form. He is asked to mount this form 
before you access the print file. A form name specified through this 
parameter takes precedence over a form name specified in symbol. Form 
names specified through VFB statements take precedence over form names 
specified through the SPL job control statement or the SPOOL jproc. 



o 
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VFB 



USES STANDI 
0UNVF1 
. 0UNVF2-CIWNVF9 J (for SDNA and AP9215-1 printers only) 
Name of a filed vertical format buffer established at SYSGEN time or via the 
job SG$PRB. If used, FORMNAME and TYPE are the only other parameters 
you can specify. When the job SG$PRB is being used to change a filed buffer, 
specify the buffer name in symbol instead of USE. 

i£NGTH-line8 

Total length of printer form in terms of lines, in the range of I to 192. 

EENSITYsf 6 1 

Number of print lines per inch. If specified, LENGTH must also be specified. 



G 



TYPE= 



SDNA 
9779 
9776 



Type of printer to be used. SDMA is used by model 7E users to specify the 
AP9215-1 printer. Only the models 8/1Q/15/2Q/50 can accommodate the 0770 
and non-SDMA 0776 printers. For all other printers (*), TYPE must be 
specified I^ the logicid unit number. If the VFB is designed to be used with 
more than one type of printer, the TYPE parameter should be omitted. 

Note: In the following keyword parameters, line is a decimal number between 1 and 
the number specified in the LENGTH keyword parameter. It specifies which 
line number is to be assigned a skip code (overflow or device control code). A 
particular code may be repeated if desired, or multiple lines for a given code 
may be specified as one parameter. If only one line is specified for a given code, 
the enclosing parentheses may be omitted. If multiple codes for a given line are 
used, the first is accepted and a diagnostic error message is given on all others. 

OVF=( I ine- 1 , - . . , I ine-n) 

Overflow line indicator. 

0VF2=(Une-1,...,Hne-n) 

Secondary overflow line indicator. 

CD1=(line-1,...,line-n),...,CDl5=(line-1,...,l1ne-n) 

Device control codes for the printer. They indicate which lines control certain 
functions, such as skipping and line spacing. See the Consolidated Data 
Management Programming Guide, UP-9978, for a list of the applicable codes 
for each printer. 



HP=n 



Line nimiber location of the home paper position. 
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c 



Notes: 



o 



o 



In a spooling system, the number of skip codes being used must be passed to the 
open processors. If a VFB job control statement is present in the device assignment 
set for a file being spooled, the number of codes specified is automatically passed 
without the necessity of an SPLjob control statement. However, if you request a 
filed vertical format buffer (STANDI or OWNVFl) having more than seven skip 
codes or if you use a system default buffer having more than seven skip codes, you 
must specify the number of codes using the no-skpcode parameter in the 1 1 SPL 
statement or the SKPCODE parameter in the 1 1 SPOOL jproc. 

When all SPL statement or 1 1 SPOOL jproc is omitted, the default is 7 skip 
codes. Three skip codes are always included in this count: home position for 
current page, overflow for next page, and home position for next page. The four 
remaining codes are user-specified. The 1 1 SPL statement and I / SPOOL jproc, 
therefore, specify the total count of lines on a form where a skip code is allowed, 
plus three. 

For 0776 printers, the CLASS= parameter should be used if a unique logical unit 
number is required. 
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VOL 



O 



Function 



Supplies the volume serial numbers used to uniquely identify tape and disk 
volumes. 

When used, the VOL statement must immediately follow the DVC statement in a 
device assignment set For a disk file, the first VOL statement must precede any 
EXT statements for that volume. 



Format 



//[symbol] VOL 



N 

Ncc 

NMcc 



volsn-l 



SCRATCH 



(i) 
(NS) 
(NOV) 
PREP 



volsn-1 



volsn-2 



SCRATCH 



(1) 1 ' 




f 


(NS> , 






<MOV) 






(PREP)J 






(i) 1 






(NS) 






(NOV) 






(PREP)J 













vol8n-2 



volsn-3 



SCRATCH 



(i) 
(NS) 
(NOV) 
(PREP) 



(i) ' 

(NS) 

(NOV) 

(PREP). 



Parameters 



o 



Suppress block number checking on input tape volumes or block number 
writing on output tape volumes. 

If N is not used, tape block numbering depends upon the SYSGEN 
specification and the BKNO parameter of the DTFMT macro. The N 
parameter is effective only during initialized processing. 



Mcc 



Mode characteristics of the tape volumes specified in positional parameters 2 
through n. The allowable values for cc are given in the Consolidated Data 
Management Progmmming Guide (UP-9978). If ilfcc is not specified, the 
mode settings specified at system generation time are used. 
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O 



NMcc 



Combines both the N and Mcc options. 



volsn-1 [ (S) 

(NS) 
(PREP) 
(NOV) J 

One to six alphanumeric chara(rt:ers specifying the volume serial number of 
the first volume of the file. If less than six characters are used, the number is 
left-justified and padded with blanks. The volume may be shareable (S) or 
nonshareable (NS), and volume checking may be suppressed (NOV). For tape 
files, a request to write volume labels may be made (PREP). Any information 
that is currently on the volume is effectively erased if PREP is specified. 

SCRATCH 

Used to specify a multivolume file without explicitly listing the serial 
numbers for each volume. May appear only once in a VOL statement and is 
always the last parameter specified. 



Notes: 



o 



i. OS/ 3 assumes that all volume serial numbers are unique. The loading of two 
volumes with identical volume serial numbers at the same time will yield 
unpredictable results. 

2. Extreme care should be taken when using the PREP option on a file to be processed 
by the librarian. When PREP is specified, the tape isprepped every time it is 
opened as output. The librarian closes output tape files whenever they are to be 
used as input and then reopens them as input If this tape file is to be reused as an 
output file within the same job, the librarian will close it as input and reopen it as 
output. This reopening will cause the file to be prepped (if PREP was specified), 
thereby effectively erasing all the information previously produced. The PREP 
option, therefore, should only be used if the file is going to be output only or output, 
then input. If this is not the case, use the TPREP utility routine to prep the file. The 
PREP option cannot be suppressed. You must redefine the tape file without 
specifying the PREP option on the VOL statement. 



volsn-1 



(1) 

(NS) 

(PREP) 

(NOV) 



(1) 
(NS) 
(PREP) 
(NOV) 



,volsn-2,. 



Continuation of a variable amount of volume serial numbers; must appear in 
the same sequence required for mounting. 



o 
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C 



Notes: 

1. To suppress checking of volume serial numbers for multivolume files, you 
must specify NOV in the VOL statement for the la^t volume of the file. 

2. For multivolume files, if PREP is specified for any of the volumes, all volumes 
in the file are prepped. 

3. SCRATCH lets you mount additional tape volumes (unlimited processing); 
however, these additional volumes are not prepped i/PREP is specified. If 
they must be initialized, use the TPREP utility routine. 

4. When referencing multivolume files on the VOL statement, you must represent 
any undeclared volume serial numbers with commas. Additionally, if neither 
Mcc, N, or NMcc are specified for the first positional parameter, you must 
supply a comma. 



2-104 UP-9984 Rev, 2 



o 



o 



/ 



/$ 



c 



/$ 



Function 

Start of data. All statements following the /$ statement up to and including the 
associated end-of-data (/*) statement are filed in $Y$RUN. 

The /$ must be the only statement on the line; however, comments may follow the 
/$ if preceded by one or more blanks. 

Format 

/$ 

No positional parameters are required. 

Note: For System 80, models 8 1 10 1 15 1 20 users: If using a Unisys 0716 card reader 
subsystem with the 96'Column card feature supported, the data file can use all 
96 columns. With data-set-label diskette, the data file can use up to 128 
characters. Job control statements, however, can only use the first 72 columns 
(characters). 



o 



o 
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/* 



r 



O 



Function 

End of data; used in conjunction with the start-of-data (/$) statement. When the 
/* statement is encountered by job control, the data file is closed and control 
stream processing is resumed. The /* statement is filed with the data. 

The /* must be the only statement on the line; however, comments may follow the 
/* if preceded by one or more blanks. 

Format 

/* 
No positional parameters are required. 



c 



o 
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O 



/& 



Function 

End of a control stream. 

The /& statement must be the only statement on the line; however, comments 
may follow the /& if they are preceded by one or more blfmks. 

Format 

/& 
No positional parameters are required. 



o 



o 
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Section 3 

Job Control Procs 



ACCESS 



Function 



Generates the job control statements required to assign a device to a job so that 
the file on that device can be accessed at job execution time. The procedure call 
statement is included in the control stream at the point where the device 
assignment set is required. This statement can be used for tape files and 
previously allocated disk files. 



Format 



//Ifdhame ACCESS 



O 



Iblname 
(Iblnone 



'f 2 1 'I ^^^^^^ \ K , voi--r voli 



DVC»nn, VOLf 
' volsn " 



volsn 

mil 



Label 



Ifdname 

Name of the file to be accessed. This corresponds to the 8-character name in 
the LFD job control statement. 

Parameters 

Iblname 

Pile identifier under which the file was created. This corresponds to the tape 
or disk file identifier in the LBL job control statement. 

n 

Number of extents in the file. Reserves extent table storage for use by the 
data access methods. The maximum value is 16. Space acquired by using this 
parameter increases the total storage requirement for the job and must be 
taken into consideration when allocating main storage. 
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ACCESS 



C 



EXTEND 

Adds information to the present end of a tape file. 

INIT 

Initializes the file, starting with the first record each time the file is opened. 
Previous control information in the format labels is ignored at file open time 
and is overwritten by specifications contained in this DVC-LFD sequence at 
file close time. 

DVC=nn 

Device type, where nn is the logical unit number of the device. 

If this keyword parameter is omitted, the file is assumed to be on the device 
containing the job's $Y$RUN file. 



VOL= 



volsn 1 

m I 



Identifies the volume where the file resides. The options are: 

VOL=volsn 

Volume serial number. 

VOL=* /— x^ 

Volume is identified in the file catalog. ii 

If this keyword parameter is omitted, the file is assumed to be in the job's 
$Y$RUNfile. 



c 
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o 



ALLOC 



Function 

Generates the job control statements required to assign a disk or diskette to a job 
step and to allocate space on that disk or diskette for the file. This statement is 
placed in the control stream where the device assignment set is required. Use it 
to create new files or extend current files. 

See Appendix B for fiirther information regarding extent specification. 
Format 



//Ifdname ALLOC 



Iblname 
(Lblnamel 



r 1 r -I DVC=nn, V0L= 
L r n 1 , J EXTEND 1 ) VOL^f volsn 1 

[li|J[liNiT tJJ[ [m \ 



volsn 



O 



o 



,EXT=C 



I ST 1 


'\ ^ 1 

CF 

F 


t\ inc 1 

e 


,r addr 1 
Tcccrhh 
BLK 




L J 


L J 


TBLK 




s 




TRK 




I OLD J 



t <bi\ai) J 



J mj 1,. 

1 Cbi,aj) I 



C,0LD3C,FIX]C,NDn) 



Label 



Ifdname 

Identifies the file; corresponds to the 8-character name in the LFD control 
statement. 



Parameters 



Iblname 

Pile identifier used when the file was created; corresponds to the disk file 
identifier in the LBL job control statement. 



Number of extents in the file. Reserves extent table storage for use by the 
data access methods. The maximum value is 16. Space acquired by using this 
parameter increases the total storage requirement for the job and must be 
taken into consideration when allocating main storage. 
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ALLOC 



EXTEND 

Adds information to the end of a sequential file. 

INIT 

Initializes the file, starting with the first record each time the file is opened. 
Previous control information in the format labels is ignored at file open time 
and is overwritten by specifications contained in this DVC-LFD sequence at 
file close time. 

DVC=nn 

Device type, where nn is the logical unit number of the device. 

If this kejnvord parameter is omitted, the file is assumed to be on the device 
containing the job's $Y$RUN file. 

VOL=r volsn 

' ii 

* 

Identifies the volume where the file resides. The options are: 

V0L=volsn 

Volume serial number. 

V0L=* 

Volume is identified in the file catalog. 

If this keyword parameter is omitted, the file is assumed to be in the job's 
$Y$RUNfile. 



EXT= 



Supplies the extent specifications to be used when reserving system 
resources for a particular file. The information is coded within parentheses. 

If this kejnvord parameter is completely omitted, job control allocates one 
cylinder of extent space for a MIRAM (MI) file and assumes one cylinder for 
dynamic extension. 

Notes: 

1. Data files must be allocated as MIRAM files. 

2, All parameters that apply to disk (except FIX) apply to format-label 
diskette. 

ST 

System access technique (SAT) file. 

Ml 

MIRAM file; only valid specification for data-set-label diskette. 



o 



o 



o 
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c 



F 



CF 



inc 



Allocate contiguous space; must be specified for data-set-label diskette 
files. 



Reformat the file at allocation time. Subparameter 4 must be BLK. 
Both C and F. 



Secondary increment (in cylinders or blocks) for automatic extension. 
An increment of zero indicates that there can be no dynamic extension 
of the file. If there is no -EXT keyword parameter for this file, the value 
of the most recently specified secondary increment is used. 



File cannot be dynamically extended. Must be specified for data-set- 
label diskette. 



o 



addr 

Absolute beginning cyKnder address, in terms of cylinders. 

Tcccihh 

Absolute track address (hexadecimal) in cylinder/head format where the 
file is to begin. Allocation is in terms of tracks. Not to be used for 
allocating a disk file or format-label diskette when creating MIRAM 
files with IRAM characteristics. 



BLK 



Allocation in terms of blocks; actual allocation is in terms of cylinders; 
only valid specification for data-set-label diskette files. 



TBLK 



mh 



TRK 



Allocates space in blocks; actual allocation is in terms of tracks. Not to 
be used for allocating a disk file or format-label diskette when creating 
MIRAM files with IRAM characteristics. 



Allocation in terms of cylinders. 



Allocates space in tracks. Not to be used for allocating a disk file or 
format-label diskette when creating MIRAM files with IRAM 
characteristics. 



o 
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OLD 

Secondary allocation increment change (siibparameter 3) for an existing 
file; cannot be followed by any other subparameters if specified; cannot 
be specified for data-set-label diskette. 

mi 

Number of cylinders or tracks to allocate for this file; subparameter 4 
must be CYL, addr, TRK, or Tccc.hh. 

(bi,ai) 

Used when allocation is in terms of blocks (by cylinder or track) for disk and 
diskette files; subparameter 4 must be BLK or TBLK. 

b! 

Is the average block length. 

ai 

Is the number of blocks to allocate. 

Subparameter 6 

Same as subparameter 5 but used to describe additional extents; never 
specified for data-set-label diskette files. 



OLD 

Indicates that the file's previously allocated extent is to be increased by the 
allocation amount (mi, (bi,ai), etc.) specified. 

If OLD is omitted, the request is for a new extent; it may not be specified for 
data-set-label diskette. 

NDI 

NDI (nondata interchange) must be specified to allocate space for all data- 
set-label diskette files that do not use the basic data exchange (BDE). 

FIX 

Indicates you're allocating this extent in the fixed-head area of an 8417 disk. 



o 



o 
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ASM 



c 



Function 



Generates the necessary job control statements to run an assembly language 
processor. Optionally, it can generate the job control statements that specify the 
following: 

• Input source library 

• Output object library 

• Procedure, copy, and alternate load libraries 

• PARAM job control statements to define the format of the assembler listing 

• OPTION job control statements to automatically execute the linkage editor 
and the generated load module 



Format 



c 



//[symbol] 



ASM 

ASML 

ASMLG 



PRNTR= 



' lun [,dest] ' 
NCdest] 
20L,destl . 


- 


,IN= 



,0UT= 



,LIN=( 



(vol -ser -no, label) 
(RES, label) 
(RUN, label) 
(*, label) 
(N) 
, (:]i?UN,$Y$RUR> 



(vol -ser-no-1, label -1) 

(RES, label -1) 

(RUN, label -1) 

(*,label-1) 

N 

(Rg$^,$yiTO:) 



(vol -ser-no, label) 
(RES) 

(RES, label) 
(RUN, label) 
(*, label) 



(vol -ser-no-2, label -2) 

(RES, label -2) 

(RUN, label -2) 

(*,label-2) 

N 

(RE$;^iHJI 



continued 
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ASM 



(cont.) 



,COPY=( 



(vol -ser-no-l, label -1) 

(RES, label -1) 

CRUN,label-1) 

(*,label-1) 

N 



,LST=r option "I 
\ (opt-1,-..opt-n) J 



(vol -ser-no-2, label -2) 

(RES,label-1) 

(RUN,label-2) 

(*,label-2) 

N 

(igE§,$yi|slRc> 



,SCR 



,SCR2= 



{vol-ser-no 1 



,ALTLOD= 



1=r vol-ser-no 1 



(vol-ser-no, label) 
(RES, label) 
(RUN, label) 
(*, label) 
(RES,$Y$LCH5> 
CRUN,^T$.RUN) 



,SYSM64= 



im 



Note: The ASM procedure call is used to assemble a program. When the ASML 

procedure call is used, an OPTION LINK job control statement is generated, 
which allows for the automatic execution of the linkage editor. When the 
ASMLG procedure call is used, an OPTION LINK,GO job control statement is 
generated, which allows for the automatic execution of the linkage editor, 
followed by the automatic execution of the program. 

When either the ASML or ASMLG procedure calls are used, the OUT parameter 
to define a specific output library cannot be used. 

Label 



o 



symbol 



Source module name of one to eight alphanumeric characters; only needed 
when the IN parameter is used. 
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Parameters 



PRNTR=r lunC,dest] 
\ NCdest] 
L 30 Eldest 3 

Specifies a printer. The options are: 



PRNTR=lunC,dest] 

Indicates a logical unit number for a printer (lun) and optionally a 1- to 
6-alphanumeric character identifier (dest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 



c 



IN= 



PRNTR=NE,destl 

Indicates that you are supplying your own device assignment set for the 
printer; a DVC-LFD sequence is not to be generated. This option allows 
use of the // LCB and // VFB statements. A 1- to 6-alphanumeric 
character identifier (dest) indicating a remote device for spooled printer 
output may also be specified when dealing with remote batch 
processing. 

If omitted, a local printer with a logical unit number of 20 is assumed. 

(vol -ser-no, label) 
(RES) 

(RES, label) 
(RUN, label) 
. (*, label) 

Input file definition; also replaces the PARAM IN control statement. The 
options are: 



IN=(vol-ser-no, label) 

Indicates the volume serial nimiber and file identifier. 

IN=(RES) 

Input is on SYSRES, in $Y$SRC. 

IN=(RES, label) 

Input is on SYSRES, but in a file other than $Y$SRC. 

IN=(RUN, label) 

Input is on the volxmie containing the job's $Y$RUN file, with the file 
identifier specified by label. 
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IN=(*, label) 

Input volume is identified in the file catalog with a file identifier 
specified by label 

If omitted, source input is in the form of data cards. 

Note: The IN parameter must be used if the source correction feature of the 
assembler (Le., SKI, REC, SEQ type cards) is to be used instead of 
strictly source cards. 



c 



OUT= 



(vol -ser -no, label) 
(RES.label) 
(RUN, label) 
(*,label) 
(N) 
, CFlUN^SYiiilSl 

Output file definition; also replaces the PARAM OUT control statement. The 
options are: 



OUT=(vol-ser-no, label) 

Indicates the volume serial number and file identifier. 



QUT=(RES, label) 

Output is on SYSRES, with a file identifier specified by label 

OUT=(RUN, label) 

Output is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by label 



o 



OUT=(*, label) 

Output volume is identified in the file catalog with a file identifier 
specified by label 

OUT=(N) 

No object code output. 
If omitted, output is in the job's $Y$RUN file. 



LIN=( 



(vol -ser-no, label - 1) 

(RES, label -1) 

(RUN,label-1) 

(*,label-1) 

N 



(vol •ser-no-2, label -2) 

(RES, label -2) 

(RUN, label -2) 

(*,label-2) 

N 



Indicates the location of the private procedure and macro libraries. RES 
indicates a library on SYSRES; RUN indicates a library on the volume 
containing the job's $Y$RUN file; the * indicates the volume is identified in 
the file catalog. The file identifier is specified by label N indicates no 
libraries. If omitted, the library is on SYSRES in the file $Y$MAC. 



c 
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COPY=( 



(vol -ser-no- 1, label - 1) 

(RES,label-1) 

(RUN,label-1) 

(*,label-1) 

N 



(vol -ser-no-2, label -2) 

(RES, label -2) 

(RUN, label -2) 

(*,label-2) 

N 



LST= 



Indicates the location of the copy Kbraries. RES indicates a library on 
SYSRES; RUN indicates a library on the volume containing the job's 
$Y$RUN file; the * indicates the volume is identified in the file catalog. The 
file identifier is specified by label, N indicates no libraries. If omitted, the 
library is on SYSRES in the file $Y$SRC. 

t option 1 

(opt- 1,-.. opt -n) J 
Specifies the format of the assembler listing. The options are: 



o 



NC 



ND 



NR 



DBG 



Specifies that no assembly listing is produced. 



Specifies that no cross-reference listing is produced. 



Specifies that no diagnostic listing is produced. 



Specifies that the cross-reference listing is to contain only symbols that 
have at least one reference each. The NC option, if specified with NR, 
always overrides it. 



Specifies a proc or macro debug mode feature within the OS/3 
assembler. 

(NC,ND} 

Specifies that neither a cross-reference nor diagnostic listing is 
produced. 



(NR,ND) 

Specifies that no diagnostic listing is produced and the cross-reference 
listing contains only symbols with references. 

SCR1=r vol -ser-no 1 
\ RE$ J 

Specifies the volume serial number of the first work file. 



SCR2= 



t vol -ser-no "I 
RJUfi J 

Specifies the volume serial number of the second work file. 
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ALTLOD= (vol -ser-no, label 
(RES, label) 
(RUN, label) 
(*, label) 

^ (RUN,$Y$RUN) 

Specifies the alternate load library that contains the assembler language 
processor. The options are: 



ALTLOD=(vol -ser-no, label ) 

Indicates the volume serial number and file identifier. 

ALTLOD=(RES, label) 

Alternate load hbrary is on SYSRES, with a file identifier specified by 
label. 

ALTLOD=(RUN, label) 

Alternate load library is on the volume containing the job's $Y$RUN 
file, with a file identifier specified by label. 



ALTL0D=(*, label) 

Alternate load library is on the volume identified in the file catalog, 
with a file identifier specified by label. 

If omitted, the alternate load library is in $Y$LOD when ASM and ASML 
are used and $Y$RUN when ASMLG is used. 



SYSM64=r YES 



m 



o 



specifies if extended mode is to be used for this assembly. 
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AUTO 



o 



o 



Function 



Generates the necessary job control statements to run RPG II auto report. 
The AUTO jproc has four forms: 



AUTO 



Processes auto report source programs. 

AUTRPG 

Processes auto report source programs and then compiles the RPG II 
generated source program. 

AUTRPGL 

Processes auto report source programs, compiles the RPG Il-generated 
source program, and link-edits the generated object module. 

AUTRPGLG 

Processes auto report source programs, compiles the RPG Il-generated 
source program, link-edits the generated object module, and executes 
the generated load module. 



Format 



//[symbol] 



AUTO 
AUTRPG 
AUTRPGL 
AUTRPGLG 



PRNTR^f lunC.dest] 
{ NCdest] 

liiliiBK 



,IN= 



(vol-ser-no, label) 
(RES) 

(RES, label) 
(RUN, label) 
(Mabel) 



,0UT= 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(Mabel) 
(N) 



,OUTSRC= 



{(vol-ser-no,label,lfd-naine,module-name) 1 
(RES, label, Ifd-name, module-name) J 



,LST= 



,SCR1ar vol-ser-no 1 ,SCR2=r vol-ser-no 1 

tits I in / 



continued 
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(cont) 



o 



,ALTLOD« 



(vol -s«r-no, label) 
(RES, label) 
(RUN, label) 
(Mabel) 



,EMB= 



r NO 



,MOD= 



C,SKIP=C] 



,COPYn= (vol-ser-no,label,lfd-name) 
(RES, label, Ifd-name) 
. (RUN, label, Ifd-name) 



[,ERRFIL=(vol-8er-no, label, module-name)} 



Label 



synibol 



Source module name of one to six alphanumeric characters; needed only 
when the IN parameter is used. 



Parameters 



PRNTR^I lun[,dest] 
N[,dest] 
20[,dest] 
Specifies a printer. The options are: 

PRNTR=lun[,dest] 

Indicates a logical unit number for a printer (lun) and optionally a 1- to 
6-alphanumeric-character identifier (dest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 



o 



PRNTR=:NC,dest] 

Indicates that you are supplying your own device assignment set for the 
printer; a DVC-LFD sequence is not to be generated. This option allows 
use of tiie // LCB and // VFB statements. A 1- to 6-alphanumeric- 
character identifier (dest) indicating a remote device for spooled printer 
output may also be specified when dealing with remote batch 
processing. 

If omitted, a local printer with a logical unit number of 20 is assumed. 
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IN=[ (vol -ser-no, label) 
(RES) 

(RES, label) 
(RUN, label) 
L (*,label) 

Input file definition; it also replaces the PARAM IN control statement. The 
options are: 



o 



OUT= 



IN=(vol-8er-no, label) 

Indicates the volume serial number and file identifier. 

IN=(RES) 

Input is on SYSRES in $Y$SRC. 

IN=(RES, label) 

Input is on SYSRES, but in a file other than $Y$SRC. 

IN=RUN, label) 

Input is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by label. 

IN=(*, label) 

Input is on the volume identified in the file catalog with a file identifier 
specified by label 

If omitted, source input is in the form of data cards. 



(vol -ser-no, label) 
(RES,label) 
(RUN, label) 
(N) 



Output file definition; also replaces the PARAM IN control statement. The 
options are: 

OUT=(vol-ser-no, label) 

Indicates the volume serial number and file identifier. 

OUT=(RES, label) 

Output is on SYSRES, with a file identifier specified by label. 

OUT=(RUN, label) 

Output is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by label. 

OUT«(*, label) 

Output is on the volume identified in the file catalog with a file 
identifier specified by label. 



o 
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OUT=(N) 

No object code output. 
If omitted, output is in the job's $Y$RUN file. 

OUTSRC=r (vol *ser -no, label, I fd-name, module-name) 1 
I (RES,lai3el,lfd-name,module-name) ] 

Output source file definition for the cataloged source file option on the auto 
report U specification. The options are: 

GUTSRC=(vol -ser-no, label , I fd-name, module-name) 

Indicates the volume serial number, file identifier (label), logical file 
name (Ifd-name)^ and module-name of the output source file. 

0UTSRC=(RES, label , If d-name, module-name) 

Indicates an output source file on SYSRES with a file identifier 
specified by label, a logical file name specified by Ifd-namej and a 
module-name for the file. 

If omitted, there is no output file definition for the cataloged source file 
option. 

LST=r K 
M 
N 
S , 

Specifies the format of the compiler listing. 



Inhibits error flags for sequence errors. 

M 

Inhibits source and diagnostic listings. 

N 

Inhibits all listable output. 

s 

Inhibits main storage map listing. 

If omitted, the complete compiler listing is printed. 
SCRl=r vol-ser-no 1 

J ttffittsm L 

\ SEi J 

Specifies the volume serial number of the first scratch work file. 

SCR2=r vol-ser-no 1 

\m J 

specifies the volume serial number of the second scratch work file. 



o 



o^ 



O' 
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ALTLOD=r (vol -ser -no, label) 
(RES, label) 
(RUN, label) 
(*,Label) 



Specifies the alternate load library containing the auto report product 
(AUTO#). The options are: 

ALTL00-(vol-8er-no, label) 

Indicates the volume serial number and file identifier Oabel). 

ALTL0D=(RES, label) 

Alternate load library is on SYSRES; a file identifier is specified by 
label 

ALTL0D=(RUN, label) 

Alternate load library is on the volume containing the job's $Y$RUN 
file; a file identifier is specified by label. 

ALTL0D«(*, label) 

Alternate load library is on the volume identified in the file catalog with 
a file identifier specified by label. 

If omitted, the AUTO# load module is located on SYSRES in $Y$LOD. 

EMB-r NO 1 

Indicates whether embedded linkage editor control statements are to be 
generated. 



MOD- 



3 
4 
5 

N0D=3 

Specifies an RPG II compilation in IBM System/34 mode. When this 
mode is specified, MIRAM will be used to process all disk files; the 
logical file definition (LFD) for printer files is changed to PRNTR, 
PRNTRl...PRNTRn; and the control reader (CTLRDR) is used for card 
input even though the data management reader (READER) is specified. 

M0D»4 

Same as M0D=3 except that printer files are generated with the same 
names as used in the program and reader files use the data 
management reader (READER). 

M0D=5 

The program is to be compiled in the IBM System/34 mode with native 
mode data management accessing the disk files. 
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SKIP^C 

Causes auto report to generate SKIP to channel for the printer output file. If 
omitted, auto report generates SKIP to line numbers for the printer output 
file. 

COPYn=r (vol-ser-no, label, Ifd-name) 1 
(RES, label, Ifd-name) [ 

. (RUN, label, Ifd-name) J 

Input source file definition for COPY statements within auto report source 
input. The number of copies corresponds to the number of unique files used 
to copy. 

COPYn=(vol -ser-no, label , Ifd-name) 

Indicates the volume serial number, the file identifier (label), and the 
logical file name (Ifd-name). 

C0PYna(RES, label , Ifd-name) 

Indicates an input source file on SYSRES with a file identifier specified 
by label and a logical file name specified by Ifd-name. 

COPYn=(RUN , I abel , I f d-name) 

Indicates an input source library in the job's $Y$RUN file with a file 
identifier specified by label and a logical file name specified by Ifd- 
name. 

If omitted, there is no input source file definition for COPY statements. 

ERRFIL=(vol -ser-no, label, module-name) 

Specifies an error log file. Error diagnostic messages are written to this file 
by the error log processor. The parameter vol-ser-nx) specifies the volume 
serial number, label specifies the file identifier, module-name specifies the 1- 
to 8-alphanimieric-character name of the error file element being created. 
(Does not need to match or be related to the RPG II source object module 
name.) 



c 



o 



c 
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Function 



Generates the necessary job control statements to run the C compiler. Its 
parameters specify the input files and the compile-time options the user wants. 



Format 



o 



o 



//symbol {CCOMP | CCOMPL | CCOMPLG} IN=< label, vol -ser-no) 
CPRNTR=({N|lun|E(il})] C,LIBl=<label,vol-ser-no)] 
C,LIB2=(label,vol-ser-no)3 C,LIBC=( label, vol -ser-no)] 
[,OUT=({label,vol-ser-no|N})] [,DEBUG={S:|NO|Y|YES}] 
[,DEFINE=(define_symbolE=initial_value]{, ... })] 
C,INTERACT={N|N0|Y|YES}3 [ , DUMP={N | NO} ] [,LIST=CN|N0| Y|YES}] 
C , S0URCE={N I NQ I Y I YES} ] [ , NRENT=0] NO | Y | YES} ] 
C, ALTL0D=( label, vol -ser-no)3 [,MAIN={HrNO|Y|YES}] 
[,PP={N|NQtY|YES}] 

Note: The CCOMP call is used to simply compile a program; the CCOMPL call 
compiles and links a program; and the CCOMPLG call compiles, links, 
and then runs a program. 

Label 

symbol 

Specifies the name of the source module to be compiled. May be from one to 
eight characters in length. 

Parameters 

I N=( label, vol -ser-no) 

Indicates the file and volume that contain the source module to be compiled. 
This parameter is required. This file is also searched for #include modules 
that cannot be located in the files named in the LIBx parameters. 

PRNTR=({N|lun|aC}) 

Specifies the printer. The options are: 

PRNTR=(N) 

Indicates that the jproc is not to create any printer JCL, because the 
user has supphed all that is required. 

PRNTR=(lun) 

Indicates that the jproc is to use lun as the logical unit number for 
printer output from the compiler. 

If omitted, the default is logical unit 20, the system default. 
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LIB1=(l«Jbel,vol-ser-Ro) V^/ 

Specifies the file name and volume serial number of the file that is to be 
searched for the #include <module-name.h> modules. If omitted, the 
$Y$SRC JIES file is used. 

LIB2=( label ,vol -ser-no) 

Specifies the file name and volume serial number of the file that is to be 
searched for the #include "module-name.h" modules. If omitted, no 
substitute is used. 

LIBC=( Label, vol 'ser-no) 

Specifies the file name and volume serial number of the file that is to be 
searched for the #include <module-name.c> or **module-name.c" modules. If 
omitted, no substitute is used. 

OUT=({label ,vol -ser-no) | N}) 

The C compiler's output is assembly language code that must be assembled. 
This parameter is used by the assembly step of the jproc to control where to 
place the resultant object module. 

OUT=(N) 

Causes the assembler step to be completely bypassed. 



OUT=( label , vol -ser-no) 

Specifies the file name and volume serial number of the file where the 
object module is to be placed. 

If omitted, the object module is placed in the same file in which the source 
module was found. If this jproc is called with the CCOMPL or CCOMPLG names, 
the object module is placed in the $Y$RUN file where LNKEDT can find it. 

DEBUG={NJ»^0|Y|YES} 

Controls the generation of debugging code that is available in the C compiler. 
When DEBUG=Y or DEBUG=YES is specified, the compiler will generate 
additional control information needed to run the built-in debugging aids. The 
default is no debugging control information. 

ALTLOD=(label , vol -ser-no) 

Specifies an alternate library file that contains the compiler to be used. If 
omitted, the $Y$LOD,RES file is used. 

DEFINE=(define_syinbol[=initial_value] {, ... }) 

Allows the definition of one or more macros to be used in the module being 
compiled. Up to 10 symbols may be defined. Each name is separated from 
the next with a comma; an equals sign is used to indicate an initial value. If 
the initial value is not specified, the value of 1 is assigned to the symbol. 



o 
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LIST={N|Kq|Y|YES} 

Controls the listings generated. 

LIST={N|NO} 

Inhibits the creation of the assembler language listing. 

LIST={Y|YES } 

Causes the compiler to produce an assembler language listing unless it 
detects errors. 

source=ChIso|y|yes } 

Controls the source listing. 

SOURCE={Y|YES} 

Causes the compiler to produce a C source listing interspersed with any 
error messages. If both LIST and SOURCE are specified, the compiler 
will produce an interspersed listing with both the C source and the 
assembly language imless it detects errors, in which case it will produce 
the C source with the error messages. 

S0URCE={N|N0} 

Inhibits the production of the C source listing. This is the default if 
SOURCE is not specified. 

PP=fN|jiq|Y|YES} 

Controls the use of the preprocessor. 

PP={Y|YES} 

Causes the compiler to stop after the preprocessor and does not 
complete the compilation. All macros are expanded and all includes are 
done. The resultant module is then written to the file specified in the IN 
parameter. 

PP={N|NO} 

Causes the compiler to complete the compilation. It is the default 
option. 

MA1N=CNIN0|Y|YES} 

Tells the compiler that the module has a main function. It controls the 
production of program initialization code. 

MA1N={Y|YES} 

Causes the compiler to produce program initialization code in the 
resultant modiile. 

MAIN={N|NO} 

Inhibits the creation of program initialization code in the module being 
compiled. This is the default if the parameter is not specified. 



o 
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NRENT=fHl1Sq|Y|YES) V^^ 

Controls iihe production of reentrant code. 

MRENT={Y|YES} 

Causes the compiler to access all data objects through base registers. 
Data may therefore be placed at any arfoitraiy location in memoiy. Also, 
the data reference address constants are generated as QCONs. 

nrenMn|no} 

Causes the data to be mapped in the object module so the code is not 
reentrant. Also, all data reference address constants are generated as 
ACONs. This is the default if NRENT is not specified. 

DUMP- {N|N0} 

Controls the OS/3 dump option. Causes the jproc not to produce an 
// OPTION JOBDUMP control statement 

If this parameter is not specified, an // OPTION JOBDUMP statement is 
generated for the compiler step. 

INTERACT=CN|.N<i|Y|YES} 

When you specify Y or YES, the compiler writes error messages to your 
terminal screen. The default is N or NO, which specifies that the compiler 
writes no output to your terminal screen and sends error messages to a 
module with the same name as the C source with a # character appended to 
it. 



o 
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C0BL74 



Function 



Generates the job control statements to execute the ANSI 1974 COBOL language 
processor. The GOBL74 jproc call has three forms: 

• COBL74: Compiles an ANSI 1974 COBOL source program. 

• COBL74L: Compiles an ANSI 1974 COBOL source program and link-edits 
object modules. 

• COBL74LG: Compiles an ANSI 1974 COBOL source program, link-edits 
object modules, and executes the load module. 



Format 



o 



//CsymboU 



C0BL74 

C0BL74L 

C0BL74LG 



PRNTRsT lun[, 
N[,de 



dest] 
dest] 



,INs 



(vol -ser-no, label) 
<RES) 

(RES, label) 
(RUN, label) 
(*,label) 



,LIN= 



(vol -ser-no, label ) 
(RES, label) 
(RUN, label) 
(*,label) 



,LINn= 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(Mabel) 



,0BJ» 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 



,SCR1 



=r vol -ser-no 1 



,SCR2=r vol-ser-no 1 ,SCR3«r vol-ser-no 1 



,ALTL0D= 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 



[,ERRFILb(voI -ser-no, label, module-name)] 



[ , opt i onsspec i f i cat i on ] 



O 
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Label 

symbol 

Source module name of one to six alphanumeric characters. Required only 
when the IN parameter is specified. 

Paiiameters 

PRNTR=r lunCdest] 
N[,dest] 

Specifies a printer. The options are: 

PRHTR=lunC,dest] 

Indicates a logical unit number for a printer (lun) and optionally a 1- to 
6-alphanumeric-characer identifier (dest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 

PRNTR=N[,dest] 

Indicates that you are supplying your own device assignment set for the 

printer; a DVC-LFD sequence is not to be generated. This option allows 

use of the // LCB and // VFB statements. A 1- to 6-alphanumeric- 

character identifier (dest) indicating a remote device for spooled printer 

output may also be specified when dealing with remote batch 

processing. ^ 

( 
If omitted, a local printer with a logical unit number of 20 is assumed. ^^-^ 
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IN=* f(vol-ser-no, label) 
(RES) 

(RES, label) 
(RUN, label) 
(*, label) 

Input file definition; also generates a PARAM IN job control statement. The 
options are: 

IN=(vol-ser-no, label) 

Specifies the file identifier (label) and the volume serial number for the 
input file. 

IN=(RES) 

Input is on SYSRES in $Y$SRC. 

IN=( RES, label) 

Input is on SYSRES, with the file identifier specified by label 

IN=(RUN, label) 

Input is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by label. 

IN=(*, label) 

Input volume is identified in the file catalog with a file identifier 
specified by label 

Note: If this parameter is omitted, source input is in the form of data cards. 



LINsf (vol -ser -no, label) 

(RES, label) 

(RUN, label) 

(*, label) 

. (RES,$Y$SRC) 

Specifies the location of the copy modules. The Ifdname is COFY$. The 
options are: 

LIN=(vol*ser-no, label) 

Specifies the file identifier (label) and the volume serial number. 

LIN=(RES, label) 

Modiiles are on SYSRES; the file identifier is specified by label 

LIN=(RUN, label) 

Modules are on the volume containing the job's $Y$RUN file; a file 
identifier is specified by label 

LIN=(*, label) 

Modules are on the volume identified in the file catalog with a file 
identifier specified by label 

If omitted, modules are on SYSRES in the file $Y$SRC. 
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OBJ= 



LINn=r (vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 

Specifies the location of additional copy libraries using LINn, where n equals 
1 through 9 (i.e., LIN1=, LIN2=,„.,LIN9=:). The compiler searches the 
libraries in the order LIN, LINl, LIN2, up to LIN9. 

(vol -ser -no, label) 

(RES, label) 

(RUN, label) 

(*,label) 

CRUNr*Y$RUN> 

Specifies the output file definition and generates a PARAM OBJ job control 
statement. The options are: 



c 



0BJ=(vol-ser- no, label) 

Specifies the location of the object module. 

OB J=( RES, label) 

Specifies that the object module is located on the SYSRES device, with 
the file identifier specified by label 



0BJ=( RUN, label) 

Specifies that the object module is located on the job's $Y$RUN file, 
with the file identifier specified by label, 

OBJ«(*, label) 

The object module is on a volume identified in the file catalog with the 
file identifier specified by label 



o 



The object module is located on the job's $Y$RUN file. This is the 
default value if the OBJ parameter is omitted. 

Note: The OBJ keyword parameter cannot be used with the COBL74L or 
C0BL74LG forms ofthejproc call 

SCR1=r vol-ser-no | 
\ RE$ J 

Specifies the volume serial number of the work file with an identifier of 
$SCR1. 

SCR2=r vol-ser-no 1 

\m \ 

Specifies the volume serial number of iihe work file with an identifier of 
$SCR2. 
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SCR3=r vol-ser-no 1 
I RUN J 

Specifies the volume serial number of the work file with an identifier of 
$SCR3. 



UP-9984Rev.2 



o 



C0BL74 



o 



ALTLOD=| (vol -ser -no, label) 
(RES, label) 
(RUN, label) 
(*, label) 
CRES,*Y$10D) 
CRUN,$YSRUN) 

Specifies the alternate load library that contains the ANSI 1974 COBOL 
language processor. The options are: 



ALTL0D=(vol-ser-no, label) 

Indicates the volume serial number and file identifier (label). 

ALTL0D=( RES, label) 

Alternate load library is on $Y$RES; a file identifier is specified by 
label 

ALTL0D=(RUN, label) 

Alternate load library is on the volimie containing the job's $Y$RUN 
file; a file identifier is specified by label 



o 



ALTL0D=(*, label) 

Alternate load library is on the volume identified in the file catalog with 
a file identifier specified by label 

If omitted, the alternate load libraiy is in $Y$LOD when COBOL74 and 
COBOL74L are used, and $Y$RUN when COBOL74LG is used. 

opt 1 on=spec i f i ca t i on 

Specifies the various compiler options. 



ERRFIL=(vol-ser-no,label,module-name) 

Specifies an error log file. Error diagnostic messages are written to this file 
by the error log processor. The vol-ser-no parameter specifies the volume 
serial number, label specifies the file identifier, module-name specifies the 1- 
to 8-alphanimieric-character name of the error file element being created. 



o 
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C0BL85 

Function 



o 



Generates the necessary job control statements to execute the COBOL language 
processor (COBL85). Optionally, it can generate the job control statements that 
specify the following: 

• Input source library 

• Output object library 

• Copy library 

• PARAM control statements that specify the compiler options 
Format 

//CsymboU 



C0BL85 


PRNTR= 


lun[,vol-8er-no] 


C0BL85L 




N 


COBL85LG 




,m 



rIN= 



(vol -ser-no, label) 
(RES) 

(RES, label) 
(RUN, label) 
(*,label) 



,LIN= 



(vol -8er*no, label) 
(RES, label) 
(RUN, label) 
(*, label) 



,LINn= 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*, label) 



,OBJ- 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 

(*,lat«l)^^^^ 



,scRi=r 



=r vol -ser-no 



,ALTLOD= 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*, label) 
(RE$,$m0P) 
CRE^,$r$RyS> 



},SCR2=r vol -ser-no 1 ,SCR3sr vol -ser-no 1 
\m \ [m I 

[ , opt 1 on=spec i f i cat i on 1 
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Label 

symbol 

Specifies the one- to six-character source module name. 

COBL85 

Specifies compilation of an ANSI 1985 COBOL source program. 

COBL85L 

Specifies compilation of an ANSI 1985 COBOL source program and link-edit 
of the object modules. 

C0BL85LG 

Specifies compilation of an ANSI 1985 COBOL soxirce program, link-edit of 
the object modules, and execution of the load module. 

Note: Device assignment sets must be specified prior to thejproc call. 

Parameters 

PRNTR= lun[,vol-ser-no] 
N 

Specifies the logical unit number of the printer. N specifies that the device 
assignment set for the printer is to be manually inserted in the control 
stream. 



IN= 



(vol -ser -no, label) 
(RES) 

(RES, label) 
(RUN, label) 
. (*, label) 

Specifies the input file definition and generates a PARAM IN control 
statement. The options are: 

IN=(vol-ser-no, label) 

Specifies the file identifier (label) and the volume serial number 
(vol-ser-no) where the source input is located. 

IN=(RES) 

Specifies that the soiu-ce input is located on the SYSRES device in 
$Y$SRC. 

IN=(RES, label) 

This is used if the source input is located on the SYSRES device, but the 
file identifier (label) is of user-own specification, not $Y$SRC. 
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IN-<RUN,label) 

Specifies that the source input is located on the job's $Y$RUN file, with 
the file identifier Gabel) of user-own specification. 



INs(*, label) 

Specifies that the source input is located on a catalog file identified by 
the file identifier (label). 



LINs 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 
CRESt;$T$SRt^ 
Indicates the location of the copy module. The options are: 



LIN=(vol-ser*no, label) 

Defines the volume serial number (vol-ser-no) and the file identifier 
(label) where the copy modules are located. The LFD name is COFY$. 

LIN=(RES, label) 

Specifies that the copy modules are located on the job's SYSRES device 
in the file identified by the file identifier flabel). 

LIN=(RUN, label) 

Specifies that the copy modules are located on the job's $Y$RUN file, 
with the file identifier Gabel) specified by the user. 

L1N=(*, label) 

Specifies that the copy modules are located on a catalog file identified 
by the file identifier flabel). 

If more than one copy library is present, the additional libraries are 
specified with the LIN/i parameter. The n value varies firom a minimum 
of 1 to a maximum of 9. The compiler searches the libraries in the 
following order: LIN, LINl, LIN2, etc., through LIN9. 

Note: Use the LINn format only withjproc calls, Jiot in PARAM statements. 
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OBJ=r (vol -ser-no, label) 

(RES, label) 

(RUN, label) 

(*,label) 

(RUN,$irSl^lM) 

Specrifies the output file definition and generates a PARAM OBJ control 
statement. The options are: 

0BJ=(vol-ser- no, label) 

Specifies the file identifier Gabel) and the volume serial number 
(vol-ser-no) where the obje<* module is located. 

0BJ=(RES, label) 

Specifies that the object module is located on the SYSRES device, with 
the file identifier specified by the label parameter. 

0BJs(RUN, label) 

Specifies that the object module is located on the job's $Y$RUN file, 
with a file identifier Gabel) of user-own specification. 

0BJs(*, label) 

Specifies that the object module is located on a catalog file identified by 
the file identifier Gabel). 

If omitted, the object module is located on the job's $Y$RUN file. 

Note: The OBJ keyword parameter must not be used with C0BL85L or 
C0BL85LG. 

SCRlsf vol-ser-no 1 

\m \ 

Specifies the volume serial number of the work file with an identifier of 
$SCR1. 

SCR2=r vol-ser-no 1 

[m^ \ 

Specifies the volume serial number of the work file with an identifier of 
$SCR2. 



SCR3i 



{vol-ser-no 1 
m J 

Specifies the volume serial number of the work file witii an identifier of 
$SCR3. 
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AULOD-I (vol -ser-no, label) 
(RES.label) 
(RUN, label) 
(*,label) 

mMmMm 

Specifies the alternate load library that contains the COBOL compiler. The 
options are: 

ALTLQDb(voI -ser-no, label ) 

Specifies the location of the compiler to be used, if other than $Y$LOD. 

ALTL0Ds(RES, label) 

Specifies that the alternate load libraxy is located on the job's SYSRES 
device in the file identified by the file identifier Oabel). 

ALTL0D=(RUN, label) 

Specifies that the alternate load library is located on the job's $Y$RUN 
file, with the file identifier Gabel) specified by the user. 

ALTL0D-(*, label) 

Specifies that the alternate load libraiy is located on a catalog file 
identified by the file identifier Gabel). 

If omitted, the compiler is loaded from $Y$RUN for execution and $Y$LOD for 
compilation and linking. 

opt i onsspec i f i ca t i on 

Specifies the various compiler options parameters (for example, UST^YES). 
It cannot specify IN, LIN, and OBJ parameters because these are job 
parameters that require job control language automatically generated l^ a 
jproc call. 



c 
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COBOL 

Function 



o 



Generates the job control statements to execute the COBOL language processor. 
Optionally, it can generate the job control statements that specify the following: 

• Input-source library 

• Output-object library 

• Copy library 

• PARAM job control statements to define the format of the compiler listing 

• OPTION job control statements to automatically execute the linkage editor 
and the generated load module 

The COBOL procedure call can be used for either the basic or extended version of 
COBOL. For the basic version, use the COBOLB, COBOLBL, or COBOLBLG 
procedure call. For the extended version, use the COBOL, COBOLL, or 
COBOLLG procedure call. When L is added to either the COBOL or COBOLB 
procedure call, an OPTION LINK control statement is generated, and the liiAage 
editor is automatically executed. When LG is added to either the COBOL or 
COBOLB procediu-e call, an OPTION LINK,GO control statement is generated 
and the linkage editor and the generated load module are automatically 
executed. 

When L or LG is used, the OBJ parameter cannot be used to define a specific 
output library. 

When the basic version is used, the specifications for the second and third scratch 
work files are ignored, as the basic version only needs one scratch work file. 
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Format 

//CsymboU 



[ COBOLB 1 




PRMTRs 


COBOLBL 






COBOLBLG 






COBOL 




L 


COBOLL 




COBOLLG 







lunC.dest] 




,IN= 


Nr,de8t] 

iEffillliil 


• 





(vol -ser-nOf label) 
(RES) 

(RES, label) 
(RUN, label) 
(Mabel) 



,OBJb[ (vol -ser-no, label) ] ,LINs 
(RES,label) 
(RUN, label) 
(*,label) 



(vol -8er*no, label) 
(RES, label) 
(RUN, label) 
(*,label) 



[,OUT=(p-lC,,..,p-n)3C,LST«(p-l,...,p-n)3 

vol-aer-no 1 ,SCR2=r vol-aer-no 1 

,ALTLOD« 



,SCRl«r 



,SCR3sf vol-ser-no 

I IRMm 



I 



(vol-ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 



O 



Label 
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symbol 

Source module name of one to six alphanumeric characters; only needed 
when the IN parameter is used. 

Parameters 

PRNTR-T lun[,de8t] ' 
{ N[,dest] 

Specifies a printer. The options are: 

PRNTR=lun[,dest] 

Indicates a logical unit number for a printer dun) and optionally a 1- to 
6-alphanumeric-character identifier (cfest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 

PRNT«=NC,dest] 

Indicates that you are supplying your own device assignment set for the 
printer; a DVC-LFD sequence is not to be generated. This option allows 
use of the // LCB and // VFB statements. A 1- to 6-alphanumeric- 
character identifier (dest) indicating a remote device for spooled printer 
output may also be specified when dealing with remote batch 
processing. 

If omitted, a local printer with a logical unit number of 20 is assumed. 
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IN= 



(vol -ser-no, label) 
(RES) 

(RES.label) 
(RUN, label) 
(*,label) 

Input file definition; also replaces the PARAM IN control statement. The 
options are: 



IN=(vol-ser-no, label) 

Indicates the volume serial number and the file identifier. 

IN-(RES) 

Input is on SYSRES in $Y$SRC. 

IN=(RES, label) 

Input is on SYSRES, but in a file other than $Y$SRC. 

IN=(RUN, label) 

Input is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by label. 

IN=(*,label) 

Input volume is identified in the file catalog with a file identifier 
specified by label 



o 



OBJ= 



If omitted, source input is in the form of data cards. 

(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 

Output file definition; also replaces the PARAM OBJ control statement. The 
options are: 



OBJ=(vol -ser-no, label) 

Indicates the volume serial number and file identifier. 

0BJ=(RES, label) 

Output is on SYSRES, with a file identifier specified by label. 

0BJ=(RUN, label) 

Output is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by label 

0BJ=(*, label) 

Output volume is identified in the file catalog with a file identifier 
specified by label 
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(vol-ser-no, label) 
(RES,label) 
(RUN, label) 
(*,label) 



LIN: 



Indicates the location of the copy module. The options are: 

LIN=(vol-ser-no, label) 

Specifies the file identifier flabel) and the volume serial number. 

LINsCRES, label) 

Modules are on SYSRES; the file identifier is specified hy label. 

LINsCRUN, label) 

Modules are on the volume containing the job's $Y$RUN file; a file 
identifier is specified by label. 

LIN=(*, label) 

Modules are on the volume identified in the file catalog with a file 
identifier specified by label. 

If omitted, modules are on SYSRES in the $Y$SRC file. 

0UT=(p-l,...p-n) 

Parameter definitions for the COBOL compiler. 



G 



LST=(p-1,-..,p-n) 

Specifies the format of the compiler listing. 

SCRl=r vol-ser-no l 
I RES ] 

Specifies the volume serial number of the first scratdi work file. 

SCR2=r vol-ser-no 1 

I Ires J 

Specifies the volume serial number of the second work file. This is ignored in 

using the basic COBOL compiler. 

SCR3=r vol-ser-no 1 
I RUIsi J 

Specifies the volume serial number of the third work file. This is ignored in 
using the basic COBOL compiler. 
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ALTLOD= (vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*, label) 

Specifies the alternate load library that contains the COBOL compiler. The 
options are: 



ALTLOD=(vol -ser-no, label) 

Indicates the volume serial number and file identifier Qabel). 

ALTLOD=(RES, label) 

Alternate load library is on SYSRES; a file identifier is specified by 

label. 

ALTLOD=(RUN, label) 

Alternate load library is on the volume containing the job's $Y$RUN 
file; a file identifier is specified by label. 

ALTL0D=(*, label) 

Alternate load library is on the volimie identified in the file catalog with 
a file identifier specified by label. 



o 



If omitted, the alternate load libraiy is $Y$LOD unless you use LG (then the 
load library is in $Y$RUN). 
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DVCDKT Q 



Function 



Assigns the same logical unit number to a diskette volume having different files 
used in a job. The logical unit numbers 130-133 (for diskette) are assigned by 
OS/3 to the different volimies as they are encountered in'the control stream. Once 
a logical unit number is assigned to a volume, this logical unit number is 
associated with the volume for the length of the job. Any other specifications of a 
different logical unit number for this volume within the job is ignored. 



Foraiftt 

//[symbol] DVCDKT vol-ser-noC,lun] 

Parameters 



,N0V0L=f Y 1 1 



vol-sep-no 

Volume serial number of the volume. 



lun 



Logical unit number to be used if different fix>m the default logical unit 
number assigned by OS/3. 



N0V0L=r Y 1 

Suppresses volixme serial number checking (NOVOL=Y). 
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DVCVOL 

Function 



Assigns the same logical unit number to a disk or volume having different files 
used in a job. Up to 10 different volumes can be defined in a single job. 

By default, the logical unit numbers 50-59 (for disk) are assigned by OS/3 to the 
different volumes as they are encountered in the control stream. Once a logical 
unit number is assigned to a volume, this logical unit number is associated with 
the volume for the length of the job. Any other specification of a different logical 
unit for this volume within the job is ignored. 

Format 

//[symbol] DVCVOL 



vol-ser-no 


[,lun] 


RES 




I RUN J 





,N0V0L«F Y 1 



Parameters 



vol-ser-no 

Volume serial number of the volume. 

RES 

Indicates the SYSRES volume is to be used. 

RUN 

Indicates the volume containing the job's $Y$RUN file is to be used. 

lun 

Logical imit number to be used if different firom the default logical unit 
numbers 50-59, which are assigned by OS/3. 

Suppresses volume serial nimiber checking (NOVOL=Y). 
Notes: 

1. The DVCVOL procedure call must be the last statement on a job control card if 
multistatement coding is used. 

2, The LBL and LFD control statements must be present in the control stream after 
the DVCVOL procedure call. An EXT control statement must also be used when 
you are allocating the file. 
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Function 



Assigns the same logical unit number to a tape volume having different files used 
in a job. Up to 10 different volumes can be defined in a single job. 

By default, the logical unit numbers 90-99 are assigned by OS/3 to the different 
volumes as they are encountered in the control stream. Once a logical unit 
number is assigned to a volume, this logical unit number is associated with the 
volume for the length of the job. Any other specification of a different logical unit 
number for this number within the job is ignored. 



Format 

//[symbol] DVCVTP vol-ser-noC 

Parameters 



■""'[™'-{ll}]["~-{U] 



vol-ser-no 

Volume serial number of the volume. 

lun 

Logical unit number to be used if different fi^m the default logical numbers 
90-99» which are assigned by OS/3. 

«-{ I } 

If specified (PREP=Y), any information currently on the volume is effectively 
erased. 

N0V0L=r Y 1 

Suppresses volume serial number checking (NOVOLsY). 
Notes: 

1. The DVCVTP procedure call must be the last statement on a job control card if 
multistatement coding is used. 

2. The LBL and LFD control statements must be present in the control stream after 
the DVCVTP procedure call 
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Function 



Generates the job control statements to execute the FORTRAN language 
processor. Optionally, it can generate the job control statements that specify the 
following 

• Input source library 

• Output object library 

• PARAM job control statement to define the format of the compiler listing 

• OPTION job control statements to automatically execute the linkage editor 
and the generated load module 

The FORTRAN procedure call can be used for basic, extended, or FORTRAN IV 
versions of FORTRAN. 

• Basic - Use the FORT, FORTL, or FORTLG procedure call. 

• Extended - Use the FOR, FORL, or FORLG procedure call. 

• FORTRAN IV - Use the F0R4, F0R4L, or F0R4LG procedure call. 

When L is added to the FOR, FORT, or F0R4 procedure call, an OPTION LINK 
control statement is generated, and the linkage editor is automatically executed. 
When LG is added to the FOR, FORT, or F0R4 procedure call, an OPTION 
LINK,GO control statement is generated, and the linkage editor and the 
generated load module are automatically executed. 

When L or LG is used, the OBJ parameter cannot be used to define a specific 
output library. 
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Format 



//[symbol] 



FORT 

FORTL 

FORTLG 

FOR 

FORL 

FORLG 

F0R4 

F0R4L 

F0R4LG 



Label 



symbol 



lunCdest] 
N[,dest} 


- 


rIN« 



PRNTRt 



,0UT»[ (vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 
NO 



(vol -ser-no, label) 
(RES) 

(RES, label) 
(RUN, label) 
(*,label) 



LsCRIsf vol-ser-no 1 1 



,ALTL0D= 



(vol -ser -no, Label) 
(RES,label) 
(RUN, label) 
(*,label) 



[,0PTs(D,N,X)}C,NDE«nt,STXeoption8] 



C,CNL=kjrLIN=r filename 1 | LLST=r k 1 ] 

[^ \%m Jj[^ 1 options IJ 

E,MAP=(S,A,L)]LsiZE=r L 1 | 

C ,ERRF I L=(vol -8er*no, I abel , module-name) ] 



Source module name of one to six alphanumeric characters; only needed 
when the IN parameter is used. 



c 
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Parameters 

PRNTR=r lun[,dest] 
N[,dest] 

Specifies a printer. The options are: 

PRNTR=lunC,dest3 

Indicates a logical unit number for a printer (lun) and optionally a 1- to 
6-alphanumeric-character identifier (dest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 

PRMTR=N,dest 

Indicates that you are supplying your own device assignment set for the 
printer; a DVC-LFD sequence is not to be generated. This option allows 
the use of the // LCB and // VFB statements. A 1- to 6-alphanumeric- 
character identifier (dest) indicating a remote device for spooled printer 
output may also be specified when dealing with remote batch 
processing. 

If omitted, a local printer with a logical imit number of 20 is assumed. 

*IN= (vol -ser-no, label) 
(RES) 

(RES, label) 
(RUN, label) 
. (*, label) 

Input file definition; also replaces the PARAM IN control statement. The 
options are: 

IN=(vol-ser -no, label) 

Indicates the volume serial number and file identifier. 

IN=(RES) 

Input is on SYSRES, in $Y$SRC. 

IN-(RES, label) 

Input is on SYSRES, but in a file other than $Y$SRC. 

IN=(RUN, label) 

Input is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by label 

IN=(*, label) 

Input volume is identified in the file catalog with a file identifier 
specified by label 

If omitted, source input is in the form of data cards. 
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OUT= 



(vol -ser-no, label) 

(RESfl^xl) 

(RUN,l^)el) 

(*,libel) 

NO 



Output file definition; also replaces the PARAM OUT control statement The 
options are: 

OUT=(vol -ser-no, label) 

Indicates the volume serial number and file identifier. 

0UT-<RES, label) 

Output is on SYSRES, with a file identifier specified by label 

OUT^CRUN, label) 

Output is on the volume containing the job's $Y$RUN file, with a file 
identifier specified l^ label 

OUT-(*, label) 

Output volume is identified in the file catalog with a file identifier 
specified by label 



c 



J 



OUT-NO 

No object code output. 



SCRIsf vol-sep-no 1 

1 tees I 

Specifies the volume serial number of the scratch work file. 



o 



ALTLOD=f (vol-8er-no,l^)el) 
(RES, label) 
(RUN, label) 
(*,label) 

mmMfmm 

Specifies the alternate load library that contains the FORTRAN language 
processor. The options are: 



ALTLOO=(vol -ser-no, label ) 

Indicates the volume serial number and file identifier Gabel). 

ALTL0D>s(RES, label) 

Alternate load library is on SYSRES; a file identifier is specified by 
label 

ALTL0Ds(RUN, label) 

Alternate load libraiy is on the volume containing the job's $Y$RUN 
file; a file identifier is specified by label 
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ALTLOD=(*, label) 

Alternate load libraiy is on the volume identified in the file catalog with 
a file identifier specified by label. 

If omitted, the alternate load library is in the job's $Y$RUN file. 

0PT=(D,N,X) 

Specifies one or all of the following compilation options: 

P 

Specifies double spacing of the compiler listing. 

N 

Specifies that no object program is to be generated. The program units 
are merely compiled and cannot be executed. 

X 

Specifies compilation of all cards with the character X in column 1. If 
this option is not specified, these cards will be treated as comments. 

This parameter is only supported for the extended and FORTRAN IV 
compilers. 

MDE^I 

Specifies that the compiler is to evaluate expressions in a strict left-to-right 
order when there is a choice, and that storage is to be allocated for variables 
and arrays in the sequence in which they were encountered. 

STX=options 

Used with the extended compiler to execute two STXIT program status 
words (PSWs). 

CNL=k 

Specifies compiler termination if a diagnostic with a severity level is 
generated. The values for k are: 

2 

Indicates academic messages, e.g., a truncated constant. 

4 

Indicates warning diagnostics, e.g., an extraneous comma in a list. 

6 

Indicates serious diagnostics, e.g., an array reference without a 
preceding array declarator. 

8 

Indicates fatal errors, e.g., insufficient storage to complete the 
compilation. 
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If the CNL parameter is not specified, the compiler processes all program 
units in the control stream, regardless of the errors encoimtered. When 
specified, the CNL parameter remains in force imtil redefined. 

This parameter is only supported for the extended compiler. 

( filename 1 

Specifies the name of the default file name in which the source modules 
reside. 



c 



ffi 



Specifies a 1- to 8-alphanumeric-character file name. 



This parameter is used with the DJ parameter and is only supported for the 
extended and FORTRAN IV compilers. 

LIBl is the default and is not supported for the FORTRAN IV compiler. 

LST=r k 1 

[ options J 

Specifies the format of the compiler listings. 

LST=k 

Specifies the options for the basic compiler only. The values for k are 

1 

Indicates source code listing. 

2 

Indicates diagnostic listing. 

4 

Indicates storage allocation map. 

7 

Is the default value. 



Indicates object code listing. 

Multiple options may be specified by adding the values for k; i.e., to 
produce both the source code and diagnostic listings (options 1 and 2), 
specify a 3 for the value of A. 
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LST=options 

Specifies the options for the extended and FORTRAN IV compilers only. The 
options are: 



Indicates an abbreviated listing consisting of only the compiler 
identification, parameters, error counts, and termination conditions. 



Indicates, in addition to the N listing, the source code listing with any 
serious diagnostics. 



Indicates, in addition to the S listing, a storage map showing the 
addresses assigned to variables and arrays. (For FORTRAN IV, M can 
be superseded by the MAP parameter.) 



Indicates, in addition to the M listing, academic and warning messages 
(extended compiler only). 



Indicates, in addition to the W listing, an object code showing the 
instructions generated for the executable statements (extended compiler 
only). 

The default is M for the extended compiler and S for the FORTRAN IV 
compiler. 

MAP=(S,A,L) 

Specifies the type of maps produced by the compiler. One or all of the 
following options may be chosen: 

s 

Specifies object summary information, including module size and 
external subroutines called. 

A 

Specifies an alphabetical listing of the addresses assigned to variables, 
arrays, and statement labels. 

L 

Specifies a listing of the variables, arrays, and statement labels in order 
by the storage locations assigned. 

When a MAP argument is specified, it supersedes the maps selected by the 
LST parameter. Also, when a MAP argument is specified, it is not necessary 
to specify LST=M. 
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This parameter is only supported for the FORTRAN IV compiler. \^) 

""•{ \ } 

Specifies the size of the FORTRAN IV compiler. The options are: 

L 

Specifies large version. 

s 

Specifies small version. 

ERRFlL-(vol-ser-no, label, module-name) 

Applies to FORTRAN IV only; specifies an error log file. Error diagnostic 
messages are written to this file by the error log processor. The vol-ser^no 
parameter specifies the volume serial number, label specifies the file 
identifier, module-name specifies the name of the error log file element being 
created. 
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FOR77 

Function 



Generates the necessary job control statements to compile a FORTRAN 77 
program. Optionally, the FOR77 procedure call statement can generate job 
control statements that specify the following: 

• Input - source library 

• Output - object library 

• II PARAM control statements defining the compiler processing information 

• Automatically link or execute the program 

The input can be embedded data cards (/$, source deck, /*) immediately after the 
FOR77 procedure call, or a module in any library as defined by the IN parameter. 

The object code can be written in $Y$RUN by default, but a specific output 
library can be specified by the OUT parameter. 

The ALTLOD parameter generates the necessaiy DVC-LFD control statement 
with the appropriate // EXEC control statement to load and execute the 
FORTRAN compiler from a private library other than $Y$LOD. 
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Format 



//[symbol] [FORT/ 
JF0R77L 
LF0R77LG 



PRNTRa: 



lun [,vol-8er-no] 
N 



,IMr 



(vol -ser-no, label) 
(RES) 

(RES, label) 
.(RUN, label) 



,OUTa 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 






I=r vol-ser-no 



vol-ser-no 



a" 

SI 



,ALTLODb 



(vol-ser-no, label) 
, (RES, label) 
(RUN, label) 

(IHSSnil) 



[,LIN-filename] 



,LIN«r (vol -sep-no, label) 1 CNIN« ,MAXa ], \um>^{ i ]\ 

(RES,label) 1 N M 

I (RUN, label) J L ^ il 



Label 



symbol 



Source module name of one to six alphanumeric characters; only needed 
when the IN parameter is used. 



F0R77 



Use this form of the FOR77 procedure call statement to compile FORTRAN 
77 source programs. 



F0R77L 



Use this fonn of the POR77 procedure call statement to compile FORTRAN 
77 source programs and link-edit the object modules (see Note 1). 



F0R77LG 



Use this form of the POR77 procedure call statement to compile FORTRAN 
77 source programs, link-edit the object modules, and execute the load 
module (see Notes 1, 2, and 3). 



G 
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Notes: 

L Linkage control cards or program data are not allowed with the FOR77LG form of 
the FOR77 procedure call statement 

2, The FOR77LG procedure call statement cannot be used when operating with the 
shared code data management feature. Instead, use the FOR77L procedure call 
statement and provide a separate 1 1 EXEC statement to execute the load module, 

3. Device assignment sets must be specified prior to thejproc. 
Parameters 



PRNTR= 



lun[,vol-ser-no] ; 

H 

20 J 

Specifies the logical unit number of the printer, and, optionally, the 
destination-id (vol-ser-no). If a printer device assignment set is not to be 
generated, the value N is coded, and the printer device assignment set must 
be manually inserted in the control stream. 

PRNTR=( lun[ ,vol -ser-no]) 

Specifies the logical unit number (20 through 29) of the printer device. 
Optionally, the destination-id (vol-ser-no) can be specified. 

PRNTR=(MC,vol-ser-no]) 

Indicates that a device assignment set for the printer must be manually 
inserted in the control stream. This permits LCB and VFB job control 
statements to be used in the control stream. The volume serial number 
can also be specified. 

If you omit the PRNTR parameter, OS/3 assumes 20 (the default). 



c 
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IN= 



(vol -ser-no, label) 
(RES) 

(RES, label) 
(RUN, label) 

Specifies the input file referenced by the PARAM IN control statement. 
When you use the IN parameter with FOR77L and FOR77LG, you must 
have a PROGRAM statement in your source program. If omitted, the source 
input is assumed to be embeddeci data cards (/$, source deck, /*). 



c 



IN=(vol -ser -no, label) 

Specifies the volume serial number (vol-ser-no) and the file identifier 
Gabel) where the source input is located. 

IN::(RES) 

Specifies that the source input is located on the SYSRES device in 
$Y$SRC. 

INs(RES, label) 

Specifies that the source input is located on the SYSRES device in the 
file identified by the file identifier (label). 

INs(RUN, label) 

Specifies that the source input is located on the job's SYSRUN file with 
the file identifier Gabel) specified by the user. 



OUT=[(vol-ser-no, label) 
(RES, label) 
(RUN, label) 
(*, label) 
;CRU»«,.$Y»RUN) 

Specifies the output file definition. If you omit it, the object code is located 
on the job's $Y$RUN file. 



OUT=(vol -ser-no, label ) 

Specifies the volume serial number (vol-ser-no) and the file identifier 
Gabel) of the file where the object code is to be located. 

OUT =:(RES, label) 

Specifies that the object code is located on the SYSRES device in the file 
identified by the file identifier Gabel). 

OUTs(RUN, label) 

Specifies that the object code is located on the job's SYSRUN file with 
the file identifier Gabel) specified by the user. 
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SCRx= vol-ser-no 

Specifies the volume serial number (vol-ser-no) of the work file labeled 
$SCRx. If you omit it, the work file defaults to the device assigned by the 
//WORKjproc. 

where: 

X 

Equalsl,2, 3, or4. 

ALTL0D= f (vol - ser-no, label ) 
(RES, label) 
(RUN, label) 
.CRUN,$Y$RUN> 

Specifies the location of the alternate load library. If omitted, the compiler is 
loaded fi-om $Y$RUN and, if not located here, then $Y$LOD. 

ALT LOD=( vol -sen -no, label) 

Specifies the volume serial number (vol-ser-no) and file identifier (label) 
of an alternate load library that contains the FORTRAN 77 compiler. 

ALTLOD=(RES, label) 

Specifies that the alternate load libraiy is located on the SYSRES 
device in the file identified by the file identifier Gabel). 

ALTL0D=(RUN, label) 

Specifies that the alternate load libraiy is located on the job's SYSRUN 
device with the file identifier Qabel) specified by the user. 



LIN= 



o 



"1 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 

Specifies the included file referenced by the PARAM LIN control statement. 
If omitted, the modules are assumed to be in file LIBl. 



LIN=(vol -ser-no, label) 

Specifies the volume serial number (vol-ser-no) and file identifier flabel) 
of an alternate load libraiy that contains the FORTRAN 77 compiler. 

LIN:i(RES, label) 

Specifies that the alternate load libraiy is located on the SYSRES 
device in the file identified by the file identifier Gabel). 

LIN=(RUN, label) 

Specifies that the alternate load libraiy is located on the job's SYSRUN 
device with the file identifier (label) specified by the user. 
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The MIN and MAX parameters specify the heap size (HPST=number). The 
heap is space required for the compiler as a work area. The default is 100. 
The amount of memory requested on the job card mixst reflect this additional 
heap size. 

The DUMP parameter indicates that a dump is desired for compile-time 
errors. 



O 
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Function 



Generates the job and linkage editor control statements needed to execute the 
linkage editor for the pinpose of creating a load module. The object modules to be 
specifically included in the load module are assumed to be in the job's $Y$RUN 
file; any object code that may have to be automatically included in the load 
module is assumed to be in $Y$OBJ, and the load module produced is assigned 
the default name LNKLOD and is stored in the job's $Y$RUN file. All these 
default options may be altered by specific parameters. The generated load 
module can also be automatically executed by specifying the LINKG procedure 
call statement. 



Format 

//[symboUr LINK \ [ input -module -name- 1,..., input -module- 



Lir LINK \ 
\ LINKG J 



10] 



O 



,PRNTRs[ lun[,dest] 
N[,de8t] 



,IN-[ (vol -ser-no, label) 
(RES) 

(RES,label) 
(RUN, label) 
(*,label) 



,0UT= 



(vol -ser-nOf label) 
(RES, label) 
(RUN, label) 
(*,label) 
(N) 



,RLIB- 



(vol-ser-no, label) 
(RES,label) 
(RUN, label) 
L (*,label) 



,ALIB- 



(vol-ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 



,SCRla 



af vol-sep-no \ ,STD»r Hi "I 

[wm I [no \ 



,ALTL0D= 



(vol -ser -no, label) 
(RES, label) 
(RUN, label) 
(*, label) 



[,0PTss' opt ions*] 



,CLIB3 



(vol -ser-no, label ,modhame) 
(RES, label ,modname) 
(RUN, label ,mo€hame) 
(*,label,modname) 



[ , CMT= * conments ■ ] [ , ENTERsexpressi on] 



O 
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Notes: 

L The LINK procedure call is used to produce a load module from object modules. 
When the LINKG procedure call is used, an OPTION GO job control statement is 
generated, which automatically executes the generated load module. 

2. When the LINKG procedure call is used, the OUT parameter to define a specific 
output library cannot be used. 

Label 

symbol 

Output load module name of one to six alphanumeric characters; this name 
is used for LOADM linkage editor control statements. It symbol is omitted, 
the value for the first input-module-name is used for the load module name. 
If the input-module-name parameter is also omitted, the load module name 
is LNKLOD. 

Parameters 

input -module-name 

Names up to 10 input modules for the generated INCLUDE linkage editor 
control statements, each name being from 1 to 8 alphanumeric characters in 
length. If COBOL-68 (extended or basic) is used, you cannot take the 6- 
character value of symbol; you must use all eight positions of the first input- 
module-name, zero-filled to the right if necessary. (You can use the input- 
module-name parameter by itself; the first input-module-name truncates to 
six characters for symbol.) 

If the input-module-name parameter is omitted, the value in the symbol field 
is assumed to be the name of the object module to be link-edited. If the 
symbol field is blank, all object modules residing in the job's $Y$RUN file are 
included. 



G 
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PRNTR= lun[,dest3 
N[,dest] 
, 20[,dest] 

Specifies a printer. The options are: 



PRNTR=lun[,dest] 

Indicates a logical unit number for a printer (lun) and optionally a 1- to 
6-alphanumeric-character identifier (dest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 



INs 



o 



PRNTRsN[,dest3 

Indicates that you are supplying your own device assignment set for the 
printer - a DVC-LFD sequence is not to be generated. This option allows 
use of the // LCB and // VFB statements. A 1- to 6-alphanumeric- 
character identifier (dest) indicating a remote device for spooled printer 
output may also be specified when dealing with remote batch 
processing. 

If omitted, a local printer with a logical unit nimiber of 20 is assumed. 

(vol -ser -no, label) 

(RES) 

(RES, label) 

(RUN, label) 

(*, label) 

(RUN,$Y$RUN) 

Input file definition; also adds a file name to the generated INCLUDE 
linkage editor control statement. The options are: 



IN=(vol*ser'no, label) 

Indicates the volume serial number and file identifier. 

IN=(RES) 

Input is on SYSRES, in $Y$OBJ. 

IN=(RES, label) 

Input is on SYSRES, but in a file other than $Y$OBJ. 

IN=(RUN, label) 

Input is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by labeL 

IN=(*, label) 

Input volume is identified in the file catalog with a file identifier 
specified by label 

If omitted, the job's $Y$RUN file is searched for object modules to include. 
The file defined in the RLIB parameter is searched next (if the RLIB 
parameter was specified), and finally $Y$OBJ is searched. 
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ajT= 



(vol -ser-no, label) 
(RES, label) 
(RUN,'abel) 
(•, label) 
(N) 
. (RUN,$Y$RUN) 

Output file definition for the output load module; also replaces the PARAM 
OUT control statement. The options are: 



c 



OUT=(vol -ser-no, label ) 

Indicates the volume and serial number and file identifier. 

0UT=(RES, label) 

Output load module is on SYSRES; a file identifier is specified by label 

OUT«(RUN, label) 

Output load module is on tiie volume containing the job's $Y$RUN file; 
a file identifier is specified by label 

0UT=(*, label) 

Output volume is identified in the file catalog with a file identifier 
specified by label 



0UT=(N) 

Output load module is not written. 

RLIB=r (vol -ser -no, label) 
(RES, label) 
(RUN, label) 
, (*,label) 

[ lenames the file to be searched in place of $Y$OBJ during automatic 
inclusion. This library is searched when no private-libraiy (ALIB) is 
specified, or when the module being sought is not found in a private library. 
The options are: 



o 



RLlB=(vol-ser-no, label) 

Indicates the volume serial number and file identifier. 

RLIB=(RES, label) 

Library is on SYSRES; a file identifier is specified by label 

RLIB=(RUN, label) 

Libraiy is on the volume containing the job's $Y$RUN file; a file 
identifier is specified by label 

RLIBs:(*, label) 

Library is on the volume identified in the file catalog with a file 
identifier specified by label 
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LINK 



ALIB-[ (vol -ser-no, label) 
(RES, label) 
(RUN, label) 
. (*, label) 

: Barnes an additional library to be used in the automatic inclusion. This 
library is always searched first during automatic inclusion in an attempt to 
locate the needed modules. If they are not found, $Y$OBJ or the library 
named by the RLIB parameter is searched. The options are: 

ALIB=(vol -ser-no- label ) 

Indicates the volume serial number and the file identifier. 

ALIB=(RES, label) 

Library is on SYSRES; a file identifier is specified by label 

ALIB=(RUN, label) 

Library is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by label 

ALIB-(*, label) 

LdbrEiry is on the volume identified in the file catalog with a file 
identifier specified by label 

If omitted, the library specified by the RLIB parameter or $Y$OBJ is 
searched, in that order. 

SCR1=r vol-ser-no 1 
JRES I 

Specifies the volume serial number of the scratch work file. 



sio 



Indicates whether the LOADM and INCLUDE linkage editor control 
statements should be generated automatically or placed physically in the 
control stream as data. If YES is used, the proper LOADM and INCLUDE 
linkage editor control statements are generated between the /$ and /* job 
control statements. If NO is used, no linkage editor control statements are 
generated; they must be placed physically in the control stream following the 
procedure call. 
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ALTLOD=r (vol -sen -no, label) 
(RES, label) 
(RUN, label) 
(*, label) 
(RUN,$Y$RUN) 

Specifies the alternate load library containing the linkage editor. The options 
are: 

ALTLOD=(vol-ser-no, label) 

Indicates the volume serial number and file identifier Oabel). 

ALTLOD=(RES, label) 

Alternate load library is on SYSRES; a file identifier is specified by 
label. 

ALTLOD=( RUN, label) 

Alternate load library is on the volume containing the job's $Y$RUN 
file; a file identifier is specified by label 

ALTLOD=(*, label) 

Alternate load library is on the volume identified in the file catalog with 
a file identifier specified by label 

If omitted, the alternate load library is in the job*s $Y$RIJN file. 



c 



OPT=' opt ions* 

Specifies the linkage editor options to be in effect. 

CLlB=r (vol-ser-no,label,modname) 
(RES, label ,modname) 
(RUN, label, modname) 
(*,label,modname) 

Specifies the location of the source module containing the linkage editor 

control statements to be processed. RES indicates a library on SYSRES; 

RUN indicates a library on the volume containing the job's $Y$RUN file; the 

'^ indicates the volume is identified in the file catalog. The file identifier is 

specified by label The name of the source module is specified by modname. 



c 



CMT='cofflment» 

Indicates the character string that will be inserted in the comment field of 
each phase header record produced for the generated load module. The 
comment must be enclosed in apostrophes and may be up to 30 characters in 
length. It may contain bl£U[iks, commas, and other special S3rmbols, excluding 
apostrophes. 
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ENTER=expression 

Specifies the transfer address. The expression may be a decimal number 
from one to eight digits, a hexadecimal number from one to six digits in the 
form X'nnnnnn', a previously defined symbol, or a previously defined symbol 
plus or minus a decimal or hexadecimal number as just described. If this 
parameter is not specified, control is transferred to the address obtained 
from the first object module in the phase that had a valid transfer address. If 
no vahd transfer address is found, control is transferred to the first CSECT 
specifically involved in the phase. 

Note: If the ASM, COBOL, FORT, or RPG procedure call is used previously in the job 
control stream, the same disk unit assigned in that procedure call must be 
assigned in this procedure call 



o 
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Function 



Generates the necessary job control statements to execute the OS/3 Pascal 
language processor. Optionally, it can generate the job control statements that 
specify the following: 

• Input source library 

• Output object library 

• Include library 

• PARAM control statements that specify additional options 



Format 



// [symbol] PASCAL CPRNTR=N] 



,IN= 



(vsn, label) 
(RES) 

(RES, label) 
.(RUN, label) 



,LIN= 



(vsn, label) 
(RES, label) 
(RUN, label) 



,0BJ' 



' (vsn, label) 1 


,ALTL0D= 


(RES, label) 




(RUN, label) 




(*,label) 




. CRUN.SY$RUN> , 





,0BJLST=: 



( » } 



[,MEM=valueK] 



(vsn, label) 
(RES, label) 
(RUN, label) 
IRES,$Y*tDP) 
I :CRES,»Y$8UN) 



,DUMP=r YES 1 



c 



Label 



symbol 



Source module name of one to six alphanumeric characters. 



PASCAL 



Specifies compilation of a Pascal source program. 

Note: No device assignment is generated by the Pascal jproc for the printer file 
OUTPUT. 
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Parameten 



IN= 



(vsn,l^>el) 

(RES) 

(RES,label) ' 

(RUN, label) 

Specifies the input file definition and generates a device assignment set for 

the file. The LFD name is INPUTFIL. The options are: 



INs(v8n,ldbel) 

Specifies the volume serial number (vsn) and file identifier flabel) where 
the source input is located. 

IN-(RES) 

Specifies that the source input is located on the SYSRES device in 
$Y$SRC. 

IN»(RES, label) 

This is used if the source input is located on the SYSRES device, but the 
file identifier (label) is of user-own spedficatioh, not $Y$SRC. 

IN-(RUN, label) 

Specifies that the source input is located on the job*s $Y$RUN file, with 
the file identifier Gabel) of user-own specification. 



o 



LIN- 



(vsn, label) 
(RES, label) 
(RUN, label). 
The options for the UN parameter are: 



LI N-(v8n, label) 

Defines the volume serial number (vsn) and file identifier {label) where 
the INCLUDE modules are located. The LFD name is INCLPILE. 

LINs(RES,label) 

Specifies that the copy modules are located on the job's SYSRES device 
in the file identified by the file identifier Oabel). 

LINs(RUN, label) 

Specifies that the copy modules are located on the job's $Y$RUN file, 
with the file identifier Gabel) specified by the user. 
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OBJ» 



(vsn, label) 
(RES, label) 
(RUN, label) 
(*, label) 

Specifies the output file definition and generates a device assignment for the 
file. The LFD name is LINKFI. The options are: 



c 



08 J=(vsn, label) 

Specifies the volume serial number (vsn) and file identifier (label) and 
where the object module is located. 

08 J=( RES, label) 

Specifies that the object module is located on the SYSRES device, with 
the file identifier specified by the label parameter. 

OBJ=(RUN, label) 

Specifies that the object module is located on the job's $Y$RUN file, 
with a file identifier (label) of user-own specification. 



08 J=(*, label) 

Specifies that the object module is identified in the file catalog with a 
file identifier specified by label. 

If the OBJ parameter is omitted, the object module is located on the job's 
$Y$RUNfile. 



ALTL0D= 



(vsn, label) 
(RES^label) 
(RUN, label) 
tRES,$Y$lbp) 
I CRES,$Y$RUN> J 



C 



ALTL0D=(vsn, label) 

Specifies the location of the compiler to be used, if other than $Y$LOD. 

ALTL0D=:(RES, label) 

Specifies that the alternate load library is located on the job's SYSRES 
device in the file identified by the file identifier Gabel). 

ALTL0D=:(RUN, label) 

Specifies that the alternate load library is located on the job's $Y$RUN 
file, with the file identifier Gabel) specified by the user. 

If the ALTLOD parameter is omitted, the compiler is loaded firom $Y$LOD. 
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OBJLST: 



■{«} 



OBJLST-NO 

Specifies that no listing of the generated object code is to be produced. 

OBJLST=YES 

Specifies that a listing of the generated object code is to be produced. 
The listing is similar to the source listing produced by the OS/3 
assembler. 

HEH=valueK 

Specifies the amount of memory to be allocated for the Pascal compiler to 
use as stack and heap space. The default is 124K 



DUMP: 



■(«}| 



O 



DUMP=i|) 

Specifies that no dump of the compiler is needed if the compiler should 
terminate abnormally. This is the default setting. 

DUMPsYES 

Specifies that a dump of the compiler is produced if the compiler should 
terminate abnormally. In addition to the dump, a walkback is produced 
which shows the dynamic sequence of function and procedure calls that 
resulted in the abnormal termination. In addition, a dump of the local 
storage of each procedure and function on the dynamic chain is 
produced to aid debugging. This option should always be used when 
reporting a problem with the compiler. 
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Function 



Generates the necessary job control statements to run the RPG II language 
processor. Optionally, it can generate the job control statements that specify the 
following: 

• Input source library 

• Output object library 

• PARAM job control statements to define the format of the compiler listing 

• OPTION job control statements to automatically execute the linkage editor 
and the generated load module 



Format 



//[symbol 



1 



RPG 

RPGL 

RPGLG 



PRNTR= 



lun[,dest] 
N[,dest} 



,IN= 



(vol -ser -no, label) 
(RES) 

(RES, label) 
(RUN, label) 
L (*,label) 



,OUTi 



(vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 
(N) 




fvol-ser-no \ j ,SCR2=f vol-ser-no 1 
RES jj r I la M 



["1 "^ }] 



,MOD: 




,ALTL0D= 



(vol -aer-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 



[,C0L=7][,C0NS0LE=lfd-name] 

[,ERRFIL=(vol -ser-no, label ,module-naine)][,HIRAH=ALL] 



EUNPKDS= JYESt] L FNAME8=rYEST] 
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Note: The RPG procedure call is used to compile a program. When the KPGL 

procedure call is used, an OPTION LINK job control statement is generated, 
which allows for the automatic execution of the linkage editor. The RPGLG 
procedure call generates an OPTION LINK,GO job control statement, which 
automatically executes the linkage editor, followed by the automatic execution 
of the program. 

When either the RPGL or RPGLG procedure call is used, the OUT parameter to 
define a specific output library cannot be used. 

Label 

symbol 

Source module name of one to six alphanumeric characters; only needed 
when the IN parameter is used. 

Parameters 

PRNTRsf lun[,clest] 
N[,dest] 

Specifies a printer. The options are: 

PRNTR=lun[,clest] 

Indicates a logical unit number for a printer (lun) and optionally a 1- to 
6-alphanumeric-character identifier (dest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 

PRNTR=NC,dest] 

Indicates that you are supplying your own device assignment set for the 
printer - a DVC-LFD sequence is not to be generated. This option allows 
use of the // LCB and // VFB statements. A 1- to 6-alphanumeric- 
character identifier (dest) indicating a remote device for spooled printer 
output may also be specified when dealing with remote batch 
processing. 

If omitted, a local printer with a logical unit number of 20 is assumed. 
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IN= (vol -ser -no, label) 
(RES) 

(RES, label) 
(RUN, label) 
(♦, label) 

Input file definition; also replaces the PARAM IN control statement. The 
options are: 



c 



INs(vol-ser-no, label) 

Indicates the volume serial number and file identifier. 

IN=(RES) 

Input is on SYSRES, in $Y$SRC. 

IN=(RES, label) 

Input is on SYSRES, but in a file other than $Y$SRC. 

IN=(RUN, label) 

Input is on the volume containing the job's $Y$RUN file; a file identifier 

is specified by label. 



IN=(*, label) 

The input volume is identified in the file catalog with a file identifier 
specified by label. 

If omitted, source input is in the form of data cards. 
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OUT= 



(vol -ser -no, label) 
(RES, label) 
(RUN, label) 
(*, label) 
(N) 

Output file definition; also replaces the PARAM IN control statement. The 
options are: 



o 



CXJT=(vol -ser-no, label) 

Indicates the volume serial number and file identifier. 

OUT=(RES, label) 

Output is on SYSRES, with a file identifier specified by label 

OUT-(RUN, label) 

Output is on the volume containing the job's $Y$RUN file, with a file 
identifier specified by label. 

0UT=(*, label) 

The output volume is identified in the file catalog with a file identifier 
specified by label. 

OUT=(M) 

No object code output. 
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LST=r K 
M 
N 
S 

Specifies the format of the compiler listing: 

K 

Inhibits error flags for sequence errors. 

N 

Inhibits source and diagnostic Hstings. 

H 

Inhibits all listdDle output. 

s 

Inhibits main storage map listing. 

SCR1=r vol-ser-no I 

[m \ 

Specifies the volume serial number of the first scratch work file. 
SCR2=r vol-ser-no 1 

\m J 

Specifies the volume serial number of the second scratch work file. 



c 



ENBs 



{yes} ^r^ 

Editor control statements are to be generated. V / 
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NODS 



3 
4 
5 

IRAN 



N0D=3 



Specifies an RPG II compilation in IBM System/S and System/34 mode. 
When this mode is specified, MIRAM will be used to process all disk 
files; the logical file definition (LFD) for printer files is changed to 
PKNTR,PRNTRl,...PRNTRn; and the control reader is used for card 
input even thoiigh the data management reader (READER) is specified. 



N0Ds4 



Same as M0D=3 except that printer files are generated with the same 
names as used in the program and reader files use the data 
management reader (READER). 



N0D«5 



O 



The program is to be compiled in the IBM System 3 and System 34 
mode with native mode data management accessing. 

NOD^IRAN 

IRAM is to be used to process all disk files. 

ALTLODsf (vol -ser-no, label) 
(RES, label) 
(RUN, label) 
(*,label) 

Specifies the alternate load library that contains the RPG II compiler. The 
options are: 



ALTL0Ds(vol-ser -no, label) 

Indicates the volume serial number and file identifier Gabel). 

ALTLOD-CRES, label) 

Alternate load library is on SYSRES; a file identifier is specified by 
label. 

ALTL0D=(RUN, label) 

Alternate load library is on the volume containing the job's $Y$RIJN 
file; a file identifier is specified by label. 

ALTL0D=(*, label) 

Alternate load hbraiy is on the volume identified in the file catalog with 
a file identifier specified by label. 

If omitted, the alternate load library is in the job's $Y$RUN file. 
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C0L=7 

Indicates that RPG II code is to begin in column 7 of the source code 
(columns 1 through 5 being used for a sequence field and column 6 being left 
blank). 

If omitted, code will begin in column 1. 

CONSOLEslfd-name 

Specifies the Ifd-name of a CONSOLE (interactive data enby) file - not a 
system console file. 

ERRFILs(vol-8er-no, label, module-name) 

Specifies an error log file. Error diagnostic messages are written to this file 
by the error log processor. The parameter vol-ser-no specifies the volume 
serial number, label specifies the file identifier, and module-name specifies 
the 1- to 8-alphanumeric-character name of the error file element being 
created. (Does not need to match or be related to the SPG II source object 
module name.) 

NIRAM^ALL 

Specifies that MIRAM is used for disk files when operating in a mixed mode 
System 80 environment. To select individual files for MIRAM, use tlie 
MIRAM parameter with the PARAM statement If this parameter is 
omitted, disk files use IRAM, ISAM, DAM, or SAM. 

UNPKDSsf YES 1 

Specifies the format of numeric data within a data structure. 

UNPICDSsYES 

Numeric data is in unpacked format. 

UNPKDS-NO 

Numeric data is in packed format. 
If omitted, the default is NO. 

FNAME8: 



{ r!s 1 

^ NO J 

specifies whether 8-character file names are allowed. 



FNAME8=YES 

8-character file names are allowed. 

FNANES^NO 

The maximum size for file names is 7 characters. 
If omitted, the default is NO. 
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Function 



Controls output spooling. When used, SPOOL must occur within the DVC-LFD 
sequence for the file to be spooled. Ignored in a nonspooling environment 



Format 



//[symboU SPOOL 



REDIRECT^ 



DISK 
TAPE 
DISKETTE 



[,BUF«nXin] 



["""■{ s}] 



, RECORDS' f n 



C«FORHNAME«forfRS] 



PAGEBRK«n] 



[SKIPC0DE=r n 1 | 
Uij 

[HDR=r NO 1 I LTESTPAGEsf NO 1 |t, 

["™'1 K* }] ["^"-i ^ }] [•"""■{ sr }] 

Note: Only the BVF.BEFAm, UPDATE, COi/[PBESS, and HOU) keyword 
parameters can be used for spooled data-set-label diskette ou^ut files. 



Parameters 



REDIRECT! 



DISK 
TAPE 
DISKETTE 

Redirects spoo 



led output (for temporaiy storage) to a disk, tape, or format- 
label diskette; output is printed or pimched later. 

REDIRECTsDISK 

Redirects spooled output to another disk volume. 

REDIRECT-TAPE 

Redirects spooled output to a tape volume. 

REDIRECTsDISKETTE 

Redirects spooled output to a format-label diskette. 

Note: A DEV operator command must not be in effect (for this copy of the output 
writer) if you specify REDIRECT=TAPE. 
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BUF=nXm 

Establishes buffers for use by the spool subfile, where n is the number of 
buffers, X is a constant, and m is the size of each buffer in 256-byte 
increments. No advantage is gained by making n greater then 2 unless 
system symbionts are being used. If this ke3rword parameter is omitted, the 
file shares the buffer pool with the job log and other spooled files not having 
their own buffers. 



COPIESs 



Number of times the spooled file is to be printed or punched (output), in a 
range of through 255. Zero indicates no output. If this kejrword parameter 
is not specified, the file is output once and then deleted from the spool file. 



SKIPC0DE=r n 1 

Used when a filed vertical format buffer having more than seven skip codes 
is requested (via // VFB) or when the system default buffer has more than 
seven skip codes. Indicates the number of lines in the buffer that contain 
skip codes, plus three (one for forms overflow and two for home paper 
position). Zero indicates no skip codes. 

RECORDS^ n 

e 

Maximum number of records (lines, includinj spaces and sldpped lines from 
print files, cards for punch files) that can be placed in the spool file before the 
operator is queried as to whether the job should be continued or terminated. 
The largest number you can specify is 262144. If this parameter is omitted, 
5120 is assumed. Value specifies no limit is put on the number of records 
that can be entered into the spool file. 

FORMNAMEsforms 

A 1- to 8-alphanumeric-character name identifying a special printer form or 
card type to the operator. 



HDRs 



Suppresses the printing of page headers in burst mode. If omitted, a page 
header is automatically printed. 

TESTPAGE=T NO 1 
I YES I 

Suppresses the query to the operator asking if a sample test pattern page is 
to be printed when a formname (FORMNAME^forms) is detected. If 
omitted, a queiy is automatically directed to the operator. This queiy, 
however, does not occur for STANDI forms. 

PAGEBRK-n 

Specifies the number of pages to be spooled out before a file is breakpointed 
and printed or punched. The largest number you can specify is 32000. 
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UPDATE= 



1 - } 

Indicates that the spool file siibdirectory is to be updated only when a file is 
closed. If UPDATE=NO is specified, all program spool output is lost if the 
system goes down or hangs. Abnormal termination of a progreun does not 
result in lost spoolout. If omitted, the spooler updates the subdirectory entry 
each time it crosses a logical track in the program file; if the program 
cancels, output generated before cancellation can be printed. 



o 



COHPRESS-J NO I 
I YES I 

Prevents the system from attempting to compress data that's directed to the 
output spool file. Normally, it should not be specified if data in the file 
contains a large number of embedded blanks or if the file has a block size 
larger than 120. Specifying COMPRESS=NO when the block size is 121 or 
greater results in an output spool file containing only one line per sector and 
requires that nXm be at least 2X4. 

RETAINsJ YES 1 
JNO I 

The output file is retained in the spool file after it is printed, punched, or 
placed on data-set-label diskette; the file can be printed, pimched, or placed 
on data-set-label diskette again at a later time. If RETAIN^YES is specified 
with REDIRECT, the output file is redirected but is also retained in the 
spool file for later processing. 

H0LD=r YES 1 
JNO I 

Spooled output file (print, pimch, or data-set-label diskette) is to be held for 
later processing. Files on hold can be released by a BEGIN SPL command or 
by a CC job control statement specifying the BEGIN SPL command. If 
HOLD^YES is specified with RETAIN, REDIRECT, or both, the file is put 
on hold and RETAIN and REDIRECT are acted upon when the file is 
released. 

SECURE=r YES \ 
I ^° J 

Suppresses the printing of the output file if the workstation to which the 
auxiliary printer is connected is not logged on. If not specified, the file is 
printed at the auxiliary printer whether or not the workstation is logged on. 
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Function 



Generates the job control statements for the device assignment sets needed by 
the data utility routine to copy or compare one disk, data-set-label diskette, or 
format-label diskette to another disk, data-set-label diskette, or format-label 
diskette. 



Format 



//ignored UDD IN=( 



vol-ser-no 

RES 

RUN 



, label Lf noext 



!]■ 



,OUT=( 



vol-ser-no 

RES 

RUN 



1, label Lr noext | | L f EXTEND \ |) 
j [18 tj[l^^" fj 



,PRNTR= 



lun[,dest] 

NC,dest] 

20I,de8t] 



,PUNCH=r YES ■|,C0MPARE=r YES \\ 



,EXT=(CMI3 



'f ^ 1 

^ CF 
F 


J inc 1 , 

e 

1 


rf addr ] 
Tccc:hh 
BLK 


1— —1 


1— 


TBLK 




CYL 




TRK 




I OLD J 



Bmi l,r mj ■|,.,71l,0LDlt,FlX]) 

(bi.ai) \ \ (bj.aj) I J 



Label 

The label will be ignored. 
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Parameters 



Supplies the information needed to define the input file. The information is 
coded within parentheses. 

vol-ser-no 

Volume serial number. 

RES 

InputisonSYSRES. 

RUN 

Input is on the volume containing the job's $Y$RUN file. 

label 

File identifier for the input file. 

noext 

Specifies the number of extents in the file. Reserves extent table storage 
for use by the data access method. 

0UT= 

Supplies the information needed to define the output file for a copy operation 
or the secondary input for a compare operation. 

vol-ser-no 

Volume serial number. 

RES 

Output (or secondary input) is on SYSRES. 

RUN 

Output (or secondary input) is on volume containing job's $Y$RUN file. 

label 

File identifier for the output (or secondary input) file. 

noext 

Number of extents in the file. Reserves extent table storage for use by 
the data access method. 

EXTEND 

Adds information to the end of a sequential file. 

INIT 

Initializes the file, starting with the first record each time the file is 
opened. Previous control information in the format labels is ignored at 
file open time and is overwritten by specifications contained in this 
DVC-LFD sequence at file close time. 
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PRNTR= lunC,dest3 
- N[,dest3 
. 2CE,dest] 

Specifies a printer. The options are: 

PRNTR=lunC,dest] 

Indicates a logical unit number for a printer Gun) and optionally a 1- to 
6-alphanunieric-character identifier fdest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 

PRNTR=NC,dest] 

Indicates that you are supplying your own device assignment set for the 
printer - a DVC-LFD sequence is not to be generated. This option allows 
use of the // LCB and // VFB statements. A 1- to 6-alphanumeric- 
character identifier (dest) indicating a remote device for spooled printer 
output may also be specified when dealing with remote batch 
processing. 

If omitted, a local printer with a logical unit number of 20 is assumed. 

PUNCH=r NO 1 
I YES I 

Cxenerates the device assignment set for the punch. This is needed when the 
punch dual output feature (DC) is selected on the data utility control card. 



COMPARES 



1,-} 

Indicates that this is a compare operation; will generate the appropriate file 
name for the secondary input. 



EXT= 



Supplies the extent specifications to be used when reserving system 
resources for a particular file. The information is coded within parentheses. 
All the parameters (except FIX) that apply to disk also apply to format-label- 
diskette. 

MI 

MIRAM file; only valid specification for data-set-label diskette. 

c 

Allocate contiguous space; only valid specification for a data-set-label 
diskette file. 



F 



Reformat the file at allocation time. Subparameter 4 must be BLK. 



CF 

Both of the preceding. 
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inc 

Secondary increment (in cylinders) for automatic extension. If there is 
no EXT keyword parameter for this file, the value of the most recently 
specified secondary increment is used. 



File cannot be dynamically extended; must be specified for data-set- 
label diskette file. 

addr 

Absolute beginning cylinder address, in terms of cylinders. 

Tcccihh 

Absolute track address (hexadecimal) in cylinder/head format where the 
file is to begin. Allocation is in terms of tracks. 

BLK 

Allocation in terms of blocks; only valid specification for data-set-label 
diskette files. 

TBLK 

Allocates space in blocks; actual allocation is in terms of tracks. 

CYL 

Allocation in terms of cylinders. 

TRK 

Allocates space in tracks. 

OLD 

Secondary allocation increment change (subparameter 3) for an existing 
file; cannot be followed by any other subparameters if specified. 

mi 

Niombers of cylinders or tracks to allocate for this file; subparameter 4 
must be CYL, addr, TRK, or Tccc hh. 

(bi,aO 

Allocation in terms of blocks (by cylinder or track); subparameter 4 
must be BLK or TBLK 

bi 

Is the average block length. 

ai 

Is the number of blocks to allocate. 
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Subparameters 6 through n f J 

Same as subparameter 5 and used to describe additional extents. 
Subparameter n+1 

OLD 

Indicates the file's previously allocated extent is to be increased by the 
allocation amount lmi,(bi,ai), etc) specified. 

If OLD is omitted, the request is for a new extent. 

FIX 

Indicates this extent is in the fixed-head area of an 8417 disk. 
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Function 

Generates the job control statements for the device assignment sets needed by 
the data utility routine to copy or compare a disk file to a tape file. 

Format 

//ignored UDT IN- •( 



vol-ser-no 
RES 

RUN 



,0UTs(vol-ser-no, label) 



1, label ITr noext 1 | ) 

j u" 'J 

.PRNTRsf lun[,dest] 1 
{ NCdest] [ 

rpUNCH* r No 1 I LCOMPARE* r P 1 | 



Label 

The label will be ignored. 
Parameters 

INs 

Supplies the information needed to define the input file. The information is 
coded within parentheses. 

vol-ser-no 

Volume serial number. 

RES 

InputisonSYSRES. 

RUN 

Input is on the volimie containing the job's $Y$RUN file. 

label 

File identifier for the input file. 

noext 

Number of extents in the file. Reserves extent table storage for use by 
the data access method. 
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OUT. ("; 

Specifies the information needed to define the output file for a copy — 

operation or the secondary input for a compare operation. 

vol-ser-no 

Volume serial number. 

label 

File identifier for the output (or secondary input) file. 

PRNTR-f lunCdest] ' 
N[,dest] 
. 2ec,dest] 

Specifies a printer. The options are: 

PRNTR-lunC,dest] 

Indicates a logical unit number for a printer (lun) and optionally a 1- to 
6-sdphanumeric-character identifier (dest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 

PRNTRsN[,de8t3 

Indicates that you are supplying your own device assignment set for the 
printer - a DVC-LFD sequence is not to be generated. This option allows 
use of the // LCB and // VFB statements. A 1- to 6-alphanumeric- 
character identifier (dest) indicating a remote device for spooled printer 
output may also be specified when dealing with remote batch 
processing. 

If omitted, a local printer with a logical unit number of 20 is assumed. 

PUNCH-J NO 1 
J YES I 

Generates the device assignment set for the pimch. This is needed when the 
punch dual output feature (DC) is selected on the data utility control card. 



COMPARES 



Indicates tlus is a compare operation; will generate the appropriate file 
name for the secondary input. 
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Function 



Generates the job control statements for the device assignment set needed by the 
UTS 400 up-line conversion routine. 



Format 



[""""!»}]■' 



//ignored UPLCNV |PRNTR=f n | |,FILn=f vsn, label, filename 

RES, label, filename 
RUN, label, filename 



O 



Label 

The label will be ignored. 
Parameters 

PRNTR=r n 1 

Specifies the logical unit number for the printer. 

FILn=[ vsn, label, filename 
RES, label, filename 
. RUN, label, filename 
Generates the device assignment set for the disk pack. 
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Function 



Generates the job control statements for the device assignment sets needed by 
the data utiKiy routine to copy or compare a tape file to a disk format-label 
diskette, or data-set-label diskette file. 



Format 



//ignored UTD IH«(vol-ser -no, label), 
OUT=( 



vol-ser-no 

RES 

RUN 



,PRNTR= 



lun[,dest] 
N[,dest] 



■'*"[{ ;}][(!:r}]' 



,EXT=( [Mn 



C 
F 
CF 



Irf 



addr 
Tccc:hh 

Ml 

TBU 
CYL 
TRK 
OLD 



(bT,ai) \\ (bj,aj) J J [^ 



,OLD]C,FIX]) 



Label 

The label will be ignored. 

Parameters 

IN=(vol-ser-no, label) 

Supplies the information needed to define the input file. The information is 
coded within parentheses. 

vol-ser-no 

Volume serial number. 



label 



File identifier for the input file. 
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Supplies the information needed to define the output file for a copy operation 
or the secondary input for a compare operation. 



vol-ser-no 

Volume serial number. 



RES 



Output (or secondary input) is on SYSRES. 



RUN 



Output (or secondary input) is on the job's $Y$RUN file. 



label 



File identifier for the output (or secondary input) file. 



Number of extents in the file. Reserves extent table storage for use by 
the data access method. 

EXTEND 

Adds information to the end of a sequential file. 



o 



INIT 

Initializes the file, starting with the first record each time the file is 
opened. Previous control information in the format labels is ignored at 
file open time and is overwritten by specifications contained in this 
DVC-LFD sequence at file close time. 

PRNTR=r lunC,dest3 
NC,dest3 

Specifies a printer. The options are: 

PRNTRslun[,dest] 

Indicates a logical unit number for a printer (lun) and optionally a 1- to 
6-alphanumeric-character identifier (dest) indicating a remote 
destination for spooled printer output (when dealing with remote batch 
processing). 

PRNTR=N eldest} 

Indicates that you are supplying your own device assignment set for the 
printer - a DVC-LFD sequence is not to be generated. This option allows 
use of the // LCB and // VFB statements. A 1- to 6-alphanumeric- 
character identifier (dest) indicating a remote device for spooled printer 
output may also be specified when dealing with remote batch 
processing. 

If omitted, a local printer with a logical unit number of 20 is assumed. 



o 



UP-9984 Rev. 2 



3«5 
Update A 



UTD 



PUNCH=r NO 1 
I YES I 

Geneiates the device assignment set for the punch. This is needed when the 
punch dual output feature (DC) is selected on the data utility control card. 

C0MPARE=r NO 1 

Indicates this is a compare operation; will generate the appropriate file 
name for the secondary input. 

EXT= 

Supplies extent specification to be used when reserving system resources for 
a particular file. This information is coded within parentheses. All the 
parameters (except FIX) that apply to disk also apply to format-label 
diskette. 

MI 

MIRAM file; only valid specification for System 80 data-set-label 
diskette. 

c 

Allocate contiguous space; only valid specification for data-set-label 
diskette file. 

F 

Reformat the file at allocation time. Subparameter 4 must be BLK. 

CF 

Both of the preceding. 



Secondary increment (in cylinders) for automatic extension. An 
increment of zero indicates that there can be no dynamic extension of 
the file. If there is no £XT keyword parameter for this file, the value of 
the most recently specified secondary increment is used. 

9 

File cannot be dynamically extended; must be specified for data-set- 
label diskette files. 

acidr 

Absolute beginning cylinder address, in terms of cylinders. 
Tcccrhh 

Absolute track address (hexadecimal) in cylinder/head format where the 
file is to begin. Allocation is in terms of tracks. 
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UTD 
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o 
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Allocation in terms of blocks; only valid specification for data-set-label 
diskette file. 

TBLK 

Allocates space in blocks; actual allocation is in terms of tracks. 

CYL 

Allocation in terms of cylinders. 

TRK 

Allocates space in tracks. 

OLD 

Secondaiy allocation increment change (subparameter 3) for an existing 
file; cannot be followed by any other subparameters if specified. 

mi 

Number of cylinders or tracks to allocate for this file; subparameter 4 
must be CTL, addr, TRK, or Tccc hh. 

(bi,ai> 

Allocation in terms of blocks (by cylinder or track); subparameter 4 
must be BU: or 7BL£ 

b\ 

Is the average block length. 

a1 

Is the number of blocks to allocate. 

Subparameters 6 through n 

Same as subparameter 5 and used to describe additional extents. 
Subparameter n+l 

OLD 

Indicates the file's previously allocated extent is to be increased by the 
allocation amount specified (mi, (bUai), etc). 

If this subparameter is omitted, the request is for a new extent. 

FIX 

Indicates this extent is in the fixed-head area of an 8417 disk. 
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WORK/TEMP 

WORK/TEMP 

Function 



The WORK and TEMP jproc calls generate any device assignment sets needed for 
temporary work files. The differences between the two jproc calls are: 

• WORK sets up temporary files for one job step and deletes them at the end 
of the job step. 

• TEMP sets up temporary files for the duration of a job and deletes them at 
the end of the job. 

• WORK generates default file identifiers beginning with $SCRn. 

• TEMP generates default file identifiers beguming with $JOB. 

Note: The file name in your program must match the file identifier generated by 
WORK or TEMP. 



Format 



\ TEMPn 



DVC=nn,VOLs 



vol-ser-no 

RES 

RUN 



VOL=r vol-ser-no 
\ RES 
I RUN 



! 



BLKsAeee 

BLK-mwi 
CYLarm 



= r nn 1 I rSECALL=f n l"] rTYPE=r file type ll 



Note: The n of WORKn I TEMPn is a number in the range 1 to 10. 
Label 

Ifdname 

File name used when the file is defined by the generated procedure 
definition. This name corresponds to the name in the LFD control statement. 

If omitted, the name generated for WORKl is $SCR1; for W0RK2, $SCR2; 
for W0RK3, $SCR3, etc; the name generated for TEMPI is $J0B1; for 
TEMP2, $J0B2, etc. 
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Parameters 

DVC»nn,VOL 



vol-ser-no 

RES 

RUM 

Specifies the work file device type. 



Is the logical unit number of the device. 

If this keyword parameter is omitted, the file is assigned to the volume 
specified by the VOL parameter, or to the device containing the job's 
$Y$RUN file for even-numbered files (W0RK2, TEMP2, W0RK4, TEMP4, 
etc) or the.SYSRES volume for odd-numbered files (W0RK3, TEMP3, 
WORKS, TEMPS, etc) if the VOL parameter is omitted. These may both be 
the same physical volume. 

vol-ser-no 

RES 

RUN 

Specifies the Volume serial number where the temporary file resides. 

VOLsRES 

Specifies the default if n in WORKn or TEMPn is odd. 

VOLsRUN 

Specifies the default if n in WORKn or TEMPn is even. 

If this keyword parameter is omitted, SYSRES on the volume containing the 
$Y$RUN file is used. 

BLK=nnnn 

Specifies the file size. 



VOLS 



Is the number of 256-byte blocks to be allocated. 

Although specified in increments of 256 bytes, the file may be formatted to 
other block sizes at OPEN time. The size is rounded up to an integral 
number of cylinders. 

If this keyword parameter is omitted and CYL^nn is also omitted, four 
thousand 256-byte blocks are allocated to the file. 
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CYL=nn 

Specifies the file size. 



Is the number of cylinders to be allocated. 

If this keyword parameter is omitted and BLK^nnnn is also omitted, four 
thousand 256-byte blocks are allocated to the file. 



1 



EXTSPs 



Number of extents reserved in the prologue. 



SECALLsf n 1 

Number of cylinders a file is extended if overflow occurs during a write 
operation. 

TYPE=r file type 1 
15T \ 

Specifics the file type for the extent. It can be either ST (SAT) or MI 
(MIRAM). If this keyword parameter is omitted, the file type is ST(SAT). 



o 



3-90 UP-9984Rev.2 \_J 

Update A 



WRTBIG/WRTSML 



c 



WRTBIG/WRTSML 



Function 

WKTBIG and WRTSML print block letters on your printed output. They function 
the same, except that the characters produced by WRTBIG are larger than the 
characters produced by WRTSML. The following characters may be used: 

Letters A through Z (upper and lower case) 

Digits through 9 

Special characters + & *-/? # = .$[]"'©><!!;%, 

Embedded blanks 

Note: On 48-character printers, some special characters may not print 

Format 

//CsymboUr WRTBIG "I 'block- V [,'block-2S,.., 'block-8'3 



]r WRTBIG "I 
\ WRTSML J 



,IN= 



(vol -ser -no, label) 
(RES, label) 
(RUN, label) 
(*, label) 



,LUN= 


[ ( 


nnn 








29 








[ N J 





,r Ifdname "I 



[,dest]) 



Parameters 



WRTBIG 



This option allows block printing of up to 12 characters on each line and lip 
to 4 lines on each page. 

WRTSML 

This option allows block printing of up to 20 characters on each line and up 
to 6 lines on each page. 

Note: It may be necessary to use the statement continuation feature of job control 
when coding your block parameters. Put a nonblank character in column 
72 and begin the next line with I In (n is a decimal number in the range 
1-9 and is used to keep track of the number of continued lines). 
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WRTBIG/WRTSML 



block 



Information to be printed on a line. Can be up to 12 or 20 characters long 
and must be enclosed within apostrophes. Blanks may be used for visual 
presentation. If the first four characters are coded as yOB$', *DAT$', TIM$', 
or VERS', the job name, system date, system time, or version number of the 
operating system in use is printed. Each may be specified alone, or with 
other options. 



IN= 



(vol-ser-no,label) 
(RES, label) 
(RUN, label) 
(*, label) 
. (RjES,$YitQP> 

Identifies the file that contains the load module called by the 
WRTBIGAVRTSML jproc. The options are: 



IN=(vol-ser-no,label) 

Indicates the volume serial number and file identifier. 

IN=(RES, label) 

Load module is on SYSRES, in the file identified by label 



IN=(RUN, label) 

Load module is on the volume containing the job's $Y$RUN file, in the 
file identified by label, 

IN=(*, label) 

L()ad module is on the volume identified in the file catalog with a file 
identifier specified by label. 



o 



LUN- 



■ ( 


nnn 

L N J 




, J Ifdnarae 




Cdest]) 



Provides a logical imit number (nnn) and a file name (Ifd-name) for the 
printer. A 1- to 6-alphanumeric-character identifier (dest) indicates a remote 
destination for spooled printer output (when deaHng with remote batch 
processing). 

If the job control proc is not to generate a printer device assignment set, code 
N as the value for this parameter and manually insert a device assignment 
set. This allows for the insertion of LCB and VFB control statements. 
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Proc Definition Statements 



END 



o 



o 



^ 



Function 



End of a procedure definition. The statements between the PROC and END proc 
definition statements are considered to be the body of the procedure definition, 
and, therefore, these statements are paired. 



Format 






LABEL 


AOPERATIONA 


OPERAND 


[[//]symbol3 


END 


unused 


Label 







symbol 

Specifies a 1- to 8-character symbol used as the target address of a branch 
instruction. 

If omitted, the END statement cannot be referenced. 

No parameters required. 
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NAME 



NAME 

Function 



Supplies the procedtire definition name. It must immediately follow the PROC 
statement. You may use more than one NAME statement, but all must be in the 
beginning of the definition. Each statement provides a unique name for the same 
definition. This name provides a reference point within the body and a soiirce 
code level. 

Multiple NAME statements allow you to specify different parameters in the 
operand fields of each NAME statement; then you may select the desired 
parameters by calling the proc by that particular name. 



Format 



LABEL 


AOPERATIONA 


OPERAND 


I//]synibol 


NAME 


parameter 



Label 

symbol 

any valid job control statement names (DVC, QGBL, etc.). 
Parameters 



Symbolic name by which the procedure definition may be called. May not be iT^] 



parameter 

Parameter or a parameter sublist to be used at job execution time. 



o 



4-2 UP-9984Rev.2 



PROC 
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PROC 

Function 



Procediu-e definition start. A valid symbol in the label field is used as a dummy 
label that represents the procname statement label. This dummy label attaches 
to the expanded procedure definition each time it enters the control stream. The 
procname statement label replaces the dummy label when the procedure 
definition is called. If the procname statement has no label, a null character 
string is used. 



Format 



LABEL 



CC//3synibol3 
Label 



AOPERATIONA 



PROC 



OPERAND 



[po8,n][,k,...,k] 



O 



symbol 

Specifies a 1- to 8-character entry point to this procedure definition when it 
is expanded and inserted into the control stream. There may be a 
corresponding label on the procname statement. 

Parameters 

pos 

Positional parameter reference sjnmbol in the body of the procediire 
definition. 

Positional parameters specified in a jproc call are associated with positional 
parameters specified in job control statements in the body of the jproc 
definition. The PROC directive specifies the number of positional 
parameters allowed. 

If omitted, no positional parameter substitution is possible. 



Decimal number that represents the total number of positional parameters 
to be foimd in the procedure call statement. 

If omitted, zero is assumed. 



o 



UP-9984 Rev. 2 4.3 



PROC 



Note: If you omit the pos and n parameters, you must still code two commas 
before you can code any keyword name values, 

k 

Represents the name or names used in referencing keyword parameters 
contained in the body of the procedure definition. 

When a keyword parameter is given a value in the jproc definition, it takes 
that value if the keyword parameter is omitted in the jproc call. To preset a 
kejrword value, the k parameter takes the form [,K=value-l,...,K=value-n]. 

If omitted, no keyword parameters are contained in the body of the 
procedure definition. 



o 



o 
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procname 

Function 



o 



Calls a control stream procedure definition. This definition must be either 
defined and available in $Y$JCS or embedded within the control stream and 
must precede any reference to it. The specified positional parameters are 
associated with certain individual positional parameters of a job control 
statement in the procedure definition body. The amoimt of positional parameters 
in this procname statement must be equal to the amount in the PROC statement. 

If the value of an omitted positional or ke3nvord parameter has been preset in the 
PROC statement, then the preset value is used in the called procedure definition. 
If the value has not been preset, then the omitted positional or ke3rword 
parameter is set to a null character string. Multiple procedure calls are not 
allowed on the same line. 

Format 

//[symbol] procname p1,p2,...,pn,ki=vi,ki,...,km=vm 
Label 

symbol 

Dummy label. When specified, this S3rmbol must correspond to the symbol 
specified in the label field of the PROC statement. 

If omitted, the value of the keyword parameter in the label field is null. 

Operation 

procname 

Procedure definition name. This must be the same name as that specified in 
the label field of the NAME statement of the called procedure definition. 

Parameters 

p1,p2,...,pn 

Represent positional parameters. 

k1=vi ,k j , . . , ,km=vm 

Represent keyword parameters. 
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( Appendix A 

Logical Unit Number Assignment 
Information 



A device may be designated by a logical unit niimber at system generation (SYSGEN) 
time. You may use a standard table or relate the logical unit numbers according to the 
conventions of the installation. The range of numbers should be as compact as possible 
to save main storage space. The logical imit numbers are set so that certain ranges of 
numbers refer to certain categories of devices. These ranges caimot be changed; only 
the specific entries within the ranges can be changed. Within each category may be 
several types of devices. For example, tape is a category; Unisys magnetic tape units 
are the types within that category. The association of liie logical imit number to the 
category and the type of device is maintained as a 512-b5rte table on the system 
resident device (SYSKES). The logical unit number is used as an index into the table. 
This association may be altered at job execution time via the EQU statement. 

Each entry in the table is four bytes long. The general format for an entry is as 
follows: 

Byte 12 3 



device- category 


device- type 


spec i a I ' hardware - features 



The following paragraphs summarize the logical unit number values for each device 
category. Refer to the installation guide for your system for information on device 
support. 



Printers 



The value range of logical unit numbers for printers is 14-29, 48, and 220-231. The 
values 20 and 21 indicate that any printer may be used. If a specific type of printer is 
required, the proper logical unit number must be used in assigning the device. The 
standard logical imit number assignments are listed in Table A-1. 
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Disk Subsystems 

The value range of logical unit numbers for disk units is 50-89 and 168-199. The 
values of 50 to 59 indicate that any disk unit may be used; the specific type of disk 
unit is not essential to the execution of the program. If a specific type of disk unit is 
required, the proper logical unit number must be used in assigning the device. The 
standard logical imit number assignments are listed in Table A-1. 

Diskette Subsystems 

The value range of logical unit numbers for diskettes is 130-153. The values 130-133 
indicate that any diskette imit may be used. 

Magnetic Tape Subsystems 

The value range of logical wait numbers for tape units is 90-129, 146-147, and 
157-159. The value of 90 indicates that any tape unit may be used; the specific type of 
tape unit is not essential to the execution of the program. If a spedfic type of tape 
imit is required, the proper logical unit number must be used in assigning the device. 
The standard logical unit number assignments are listed in Table A-1. 

Workstations O 

The value range of logical unit numbers for workstations is 200-219. The values 
200-215 indicate that any workstation may be used. 

Card Reader Subsystems 

The value range of logical unit numbers for card readers is 30-39. The values 30 and 
31 indicate that any reader may be used. If a specific type of reader is required, the 
proper logical unit number must be used in assigning the device. The standard logical 
xmit number assignments are listed in Table A-1. 

Card Punch Subsystems 

The value range of logical unit numbers for punch imits is 40-47. The values 40 and 
41 indicate that any pimch imit may be used. If a specific type of punch imit is 
required, the proper logical imit number must be used in assigning the device. The 
standard logical unit number assignments are listed in Table A-1. 



r 
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Standard Logical Unit Numbers 



Table A-1 provides the standard logical unit numbers and their corresponding device 
types. 



Table A-1. Standard Logical Unit Number Assignments 



C) 



26,27 

28,29 

30,31 

32,33 

34,35 

36.37 

38,39 

40,41 

4245 

46,47 

48 

49 



AP9215-1 printer, no features specified 

0770 printer, no optional features specified 

Any card reader subsystem, no features specified 

0717/0719 card reader, no feature specified 

0716 card reader, no features specified 

0711 card reader, no features specified 

Spare 

Any card punch subsystem, no features specified 

Spare 

0608 card punch 

Any remote printer, no features specified 

Spare 



Logical 

Unit 

No. 


Devieo Typo and FoaturM 


Devica 
TypaCoda 


1-13 


Spare 


ymm\- 


14.15 


0791 Correspondence quaTify printer (CQP-1) 


04040000 


16.17 


0798 printer, no features specified 


04010000 


18.19 


0789 printer 


04020000 


20,21 


Any printer, no feature specified 


O4F000O 


22,23 


9246 printer, no features specified 


04400000 


24.25 


0776 printer, no optional features specified 


04100000 



04200000 

04800000 

08F0000 

08200000 

08800000 

08400000 

08100000 

02FF0000 

FFITFFFF 

02010000 

04FF8000 

ITFFRFFF 
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Table A-1. Standard Logical Unit Number Assignments (cont.) 



Logical 

Unit 

No. 



Device Type and Features 



50-59 


Any disk 


6063 


8419 disk subsystem 


64^ 


8416/8418 MODI disk sub^stem (low density) 


67-69 


8418 IVIODII disk subsystem (high density) 


70-74 


8430 disk subsystem 


75-79 


8433 disk subsystem 


80«5 


8494 disk subsystem 


8&e9 


SCSI disk (9493, 9493H. 9610) 


90-99 


Any tape, no features specified 


100-102 


Any tape, 9-track phase<ncoded 


103-105 


Any tape, 9-trackNRZI 


106-109 


Any tape, 7-trackNRZI 


110-112 


U26.U28,BT32tape 


113-115 


U10.U14tape 


116-118 


U12.U16tape 


119-121 


U20tape 


122-124 


SCSI tape (2145) 


125-127 


U22.U24tape 


128-129 


Streaming tape (Ull) 


130-133 


Any diskette 


136-137 


8420/8422 diskette 



Device 
Type Code 



20F0CX)0 

20108000 

20028000 

20028004 

20200000 

20200004 

2001C000 

2080C0O0 

lOFFOOOO 

lOFFOOOA 

10F0006 

10F0005 

10800000 

10080000 

10400000 

10100000 

10200000 

10010000 

1002000A 

40FFOO0O 

40010000 
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Table A-1. Standard Logical Unit Number Assignments (cont.) 
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Logical 

Unit 

No. 


Device Type and Features 


Device 
Type Code 


138, 139 


Any diskette, 12843yte 


400F0001 


140-141 


Any diskette, 25&byte 


400F0001 


142-143 


Any diskette, 512-byte 


400F0004 


144-145 


Any diskette. 10244)yte 


400F0008 


146-147 


Any tape, 9-trackGCR 


10FF0042 


148-149 


Doubledensify diskette (MFM recording) 


40FF0020 


150, 151 


Any diskette, autoload 


40FF0100 


152, 153 


Any diskette, double-sided 


40FF0040 


154-156 


Spare 


FFFFFFFF 


157-159 


5073 tape 


10200080 


160-167 


Spare 


hH-FFFFF 


168, 169 


Ariyfixed^ieaddisk 


20080020 


170-174 


8417 disk subsystem 


2008COOO 


175-179 


8470 disk subsystem 


20040000 


180-185 


M9720 disk subsystem 


2001C004 


186-188 


Spare 


FFFFFFF 


190-199 


Spare 


FFFFFFF 


20^215 


Any workstation 


OlFOOOO 


216-219 


Any workstation with 24 x 80 screen 


01FF0004 


220-223 


Ally printer, class=l 


04FF0001 
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Table A-1. Standard Logical Unit Number Assignments (cont) 



Logical 

Un'rt 

No. 


Device Type and Featurae 


Device 
Type Code 


224-227 


Any printer, class=2 


04FF0011 


228-231 


Any printer, class=3 


04FF0111 


232-254 


Spare 


m\-\-hi- 


255. 256 


Any worl(Stat>on with printer attached 


01F0080 
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Files are defined on direct access storage devices in terms of extents. An extent is 
space on the volume reserved for the file and is made up of contig^ious cylinders. Piles 
may be 1 to 16 extents for each volume in the file and may be allocated to any 
available area on the disk pack. Space on a disk may be allocated on a contiguous or 
noncontiguous basis, depending on your job requirements. You can request space on a 
disk in one of the following ways: 

• Absolute address (cylinder or track) 

The starting address of your file specified as the absolute address of a cylinder or 
track. The number of cylinders and tracks required also must be specified. 

• Number of tracks 

You can allocate files by specifying the number of tracks needed. This allows you 
to manage your file space more efficiently than if you allocate files by cylinder. 

• Number of cylinders 

You can state the number of cylinders your file needs, rather than stating the 
exact starting address. Job control places your file in an area that is the best fit 
with the other files on the disk. Your starting address is placed in the volume 
table of contents and returned to the job in the file control block. However, you 
need only request the file by name; the software accesses it for you. 

The allocation is in terms of whole cylinders. 

• Number of blocks (by cylinder) 

You can state the number of blocks in the file and the average length of the 
blocks; job control calculates the amount of space needed to fulfill your request. 
The amount of space assigned varies with the type of disk subsystem used. This 
method is the most flexible way to allocate extents on a disk since it is not device 
dependent. 

• Nimiber of blocks (by track) 

You can also allocate a file by specifying the number and average length of blocks 
it requires and have that specification converted to the number of tracks needed. 
The actual allocation, in this case, is by track. 



o 



UP-9984Rev.2 B-1 



c 



o 



O' 



c 



Glossary 



o 



A 

audit file 

Optional file produced by the audit version of the dialog processor. It contains a record 
of your responses during a dialog session. 

audit version of the dialog processor 

The version of the dialog processor that produces an audit file. 



COMRE6 

A 12-byte communications region in ihejob preamble available to the user for passing 
vital information firom one job step to another. The last byte is the UPSIhyte (user 
program switch indicator). 



data set delimiters 

The /$ and the /* control statements. They should follow the EXEC control statement 
in the control stream or, if used, any PARAM control statements. When job control 
detects the /$ statement, it reads without verifying and places in the job's $Y$RUN file 
all subsequent statements up to and including the /* statement. The data set within 
the delimiters maybe source code or other control statements. 

data set labels 

The data set labels are similar in function to a VTOC. They reside on head O and 
describe the types of records and their characteristics that make up the diskette file. 

device assignment sets 

The job control statements used to identify your devices and files to the system. A 
device assignment set can include these statements: DVC, VOL, EXT, LBL, UID, 
USE, LFD. 

dialog processor 

An OS/3 system program that manages interactive dialogs, including Hie job control 
dialog. 

dummy data set 

A dummy data set consists of only a /$ and /* statements. They are used with some 
language jprocs. 
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file cataloging 

The method of maintaining, in a centralized catalog, all the information needed by a 
job to access a file that is common to other jobs as well. Also provides protection 
against unauthorized access or update by using read/write passwords. 

file control block (FCB) 

Contains information needed to control a specific file. 

file identifier 

The physical label of a file. It is specified in the LBL control statement and may be up 
to 17 characters for a tape file and 44 characters for a disk or format-label diskette 
file. It is used to locate the volume table of contents (VTOC) entry that contains control 
information for the file. 

It is advisable to have the file identifier different from the/iZe name. 

filename 

The name of the logical file specified on the LFD statement is considered to be an 
"internal" file name. It must be the same as the name specified in the label of the DTF 
macroinstruction when the file is defined for data management, or in the label field of 
the DTFPF macroinstruction when the physical IOCS fimction of the supervisor is 
used. It is logical file name that you use when you want to access the file. 

The LFD file name is used to access the file control block associated with this 
particular file. Job control generates several control tables/blocks; each is made up of 
related information. 

file processor 

Reads control streams firom the card reader and permanently stores them in $Y$JCS. 
The control streams may consist of control statements, procedure definitions, or both, 
and each control stream must be given a unique name. No vaUdity check is made at 
the time a control stream is stored in $Y$JCS. The file processor is activated by the 
FILE operator command or the FILE workstation command. 

I 

interactive processing 

A computing environment where you commimicate with the operating system through 
a workstation. 
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interstep processor 

Performs end-of-job functions and final housekeeping duties required at the end of a 
job step. These include. 

• releasing devices not required by the remaining job steps in the jo6; 

• releasing temporaiy and user-specified disk space; 

• storing pertinent logging data. 

• calling thejoft step processor (if this is not the last job step); and 

• calling Hie job termination function (if this is the last job step). 

J 

JC$BLD 

A system program that uses your responses to the job control dialog to build a job 
control stream or user jproc. The program is initiated by the SC JC$BLD workstation 
command. 

job 

O A unit of work to be performed. Each job can be divided into job steps (programs) to be 

executed serially and must be given a imique name. 

job control dialog 

Unisys supplied dialog that guides you step-by-step through the process of building a 
job control stream or user jprocs. 

job run library file 

The default job temporaiy library for most system processors to use for input/output 
storage. 

The file identifier for the temporary job run library file is $Y$RUN. 

job prologue 

Area reserved at the beginning of the job region in main storage that includes the job 
preamble, any extent request tables, tiie task control blocks, open file table, and job 
accounting table. 

job queue 

Contains an entry for each job defined and stored in a $Y$RUN file. The entiy is filed 
according to one of three priorities: normal, high, or preemptive. 

job scheduler 

Schedules jobs for execution based on a 3-level priority queue. 
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job step 

Unit of work associated with one processing program. A job step is an executable 
program consisting of one or more tasks that requires a specific amount of the 
hardware resources of the system, 

job step processor 

Prepares a job step for execution. This includes: 

allocating devices for the job step; 

locating and updating the file control blocks for this job step; 

posting the disk address of data in the job preamble; 

setting option indicators; 

requesting disk space allocation or file extension 

storing system logging information; 

performing any requested utility functions; and 

performing housekeeping and bookkeeping functions for the job step as required 
by the system. 

The job step processor terminates when the user program is brought in for execution. 

job termination 

Either the normal or abnormal end of a job. All terminations result in the deallocation 
of all system resources (such as peripheral devices, main storage, and disk scratch 
area) previously allocated to the job. Any remaining data images or control statements 
in the control stream are bypassed. 

• Normal Terminations 

These are initiated by the program, control stream, or system operator. 

• Abnormal Terminations 

These are caused by program errors, control stream errors, or the expiration of 
the estimated processing time for the job. 



logical unit number 

A number preassigned to a unit by device type and characteristics at each installation. 
This number is used to access an entiy in a control table contains the type of device 
being assigned, plus information regarding the use of that device. 



c 



o 



c 



Glossary4 UP-9984 Rev. 2 



o 



o 



Glossary 



M 

main storage allocation/requireinents 

The assignment of blocks of main storage to jobs and system functions. 

The minimum amount of space need be only that required for the longest load module 
in your program. Job control calculates how much additional space is required for the 
various control tables. This establishes the true minimum amount of main storage 
space that your program uses for its execution. 

mult^'obbing 

The concurrent scheduling, loading and execution of more than one job at a time. OS/3 
job control can initiate up to 7 or 47 jobs concurrently, depending on your system 
configuration. 

multiple indexed random access method (MIRAM) 

Allows processing of logical records by relative record nimiber in a random or a 
consecutive order or by multiple keys (indexed) in a random or a sequential order. Up 
to five keys can be searched. 

multitasking 

Executing asynchronous multiple tasks within a given job step. 



phase name 

The program name plus the 2-digit phase number appended by the linkage editor. The 
combined program name/phase number is placed in the phase header generated by 
the linkage editor. 

physical unit block (PUB) 

A control block in main storage containing the peripheral device information used by 
the physical I/O control system (PIOCS). 

program name 

The name of the program that is to be executed in the job step. This is the name given 
to the load module by the linkage editor. 
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run processor 

Identifies, interprets, and analyzes the statements in the second stream. Based on this 
information, the run S3nnbiont: 

• builds the control blocks that describe the job requirements to the system: 

• creates a temporary run library for the job; 

• expands job control procedure calls; 

• places an entry for the job in the job queue for scheduling; and 

• passes control to the job scheduler. 



scheduling priorities 

The control streams for jobs submitted for execution are queued on the system 

resident device (SYSRES) by a scheduling priority. This priority is specified on either 

the JOB statement or the RUN statement and is normal, high, or preemptive. The 

priority applies to the entire 706 and is considered to be normal unless otherwise /""A 

specified. High priority should be reserved for emergency scheduling situations and is, \_J 

therefore, rarely used. Preemptive priority is higher and causes the ctirrently 

executing job to be preempted. A priority specified on the RUN statement overrides a 

priority specified on the JOB statement. 

spooling 

The process of having the central processor reading or writing records from or to a 
high speed device, rather than directly from a slower device. 

summary report 

An optional printed report output by the dialog processor that contains a summary of 
a dialog session organized by sequentially numbered paragraphs. 

switching priority 

Determines the order in which central processor control is passed from task to task. 
The number of user switching priorities varies from 1 to 62. The number of priorities 
is established at system generation time. The minimum supervisor configuration 
requires only one priority, regardless of whether there is multijobbing or multitasking 
environment. 

system access technique (SAT) 

A specialized block level device handler that provides great efficiency in handling disk 
files. 
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system information block (SIB) 

An area in main storage containing system control information. 

system job control libraiy file ($Y$JCS) 

Provides permanent storage for control streams. It can be used as the output file for 
the file processor and can be input to the run processor whether by specification or by 
default. 

system library 

A name, generally used to refer to the standard system files in an operating system. In 
OS/3, the system library includes five permanent system library files and a temporary 
job run library file for each job input to the system: 

• System load library file ($Y$LOD) 

• System object library file ($Y$OBJ) 

• System source library file ($Y$SRC) 

• System macro, or procedure, library file ($Y$MAC) 

• System job control stream library file ($Y$JCS) 

• Temporary job run library file ($Y$RUN jobname) 

The preceding breakdown is defined by the operating system. OS/3 supports different 
system programs. Library files may be composed of both user and system programs. 
Such a mix is transparent to the librarian. 

system load library file 

Provides permanent storage for the executable programs (load modules) supplied as 
part of the operating system. Can also be used to provide permanent storage for user 
load modules. This file is used as the input library by the system loader. 

The file identifier for the system load libraiy file is $Y$LOD. 

system macro libraiy file 

Provides permanent storage for the standard system macro definitions. Can also 
provide permanent storage for user macro definitions. This file is used as an input 
library by the assembler macro facility. 

The file identifier for the system load libraiy file is $Y$MAC. 

system object libraiy file 

Provides permanent storage for the object modules applied as part of the operating 
system. Can also provide permanent storage for object modules of user programs. This 
file is used as an input library by the linkage editor. 

The file identifier for the system object library file is $Y$OBJ. 
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system source libraiy file 

Provides permanent storage for source modules that consist of source coding as 
processed by language processors. 

The file identifier for the system source Ubrary file is $Y$SRC. 



task 

A point in a program where central processor control is reqxiired for continued 
program execution. Every job step has at least one task, and there may be a maximum 
of 256 tasks. Also see switching priority and multitasking, 

task control block (TCB) 

An area in the job prologue containing information needed to control a specific task. 

u 

user program switch indicator (UPSD 

Last byte of the 12-byte communication region in theyo6 preamble. The two most 
significant bits of the UPSI byte are used to communicate error conditions to the user. 



volume serial number 

One to six alphanumeric characters used to identify a physical tape or disk volume. 
All disk packs and magnetic tape units, including scratch volumes, should be assigned 
a volume serial number. Each installation may have its own system for numbering 
volumes. 

volume table of contents (VTOC) 

Contains the address of all information stored on a direct access volume. 

The VTOC is made up of seven different format labels, defined as follows: 

• Format Label 

The format label represents available space within the extent of the VTOC itself. 
The format label contains all binary O's. When a format 1, 2, 3, 5, or 6 label is deleted 
from the VTOC, a format label is written in its place. 



c 



o 



o 



Glossary-S UP-9984 Rev. 2 



o 



o 



Glossary 



• Format 1 label 

The format 1 label identifies any file on a disk volume except for the VTOC file itself. 
There must be one format 1 label for each file or part of a file on each volume. Up to 
three contiguous or noncontiguous areas, or extents, occupied by the file can be 
identified in the format 1 label. One format 2 label or one format 3 label can be 
chained to a format 1 label. 

• Format 2 Label 

The format 2 label provides additional description for a format 1 label. If present, the 
format 2 label is chained to a format 1 label. 

• Format 3 Label 

The format 3 label is used if the file consists of more than three extents. If present, the 
format 3 label is chained to a format 1 label, format 2 label, or another format 3 label. 
A format 3 label can describe up to 13 extents. 

• Format 4 label 

The format 4 label describes the VTOC itself. It is always the first record in the VTOC 

• Format 5 label 

The format 5 label describes up to 26 contiguous or noncontiguous extents that are 
available for allocation on a volume. It is always the second record in the VTOC. 
Several format 5 labels may be chained together if more than 26 contiguous or 
noncontiguous extents are available on the volume. 

• Format 6 Label 

The format 6 label describes up to 26 split-cylinder extents. Format 6 labels may be 
chained together, with the first format 6 label being chained to the format 4 label. 

All format labels are described in detail in the data management user guide. 

w 

workstation 

A terminal device with a screen for display of system and user information (including 
dialog text) and a keyboard for user input (including responses to a dialog). 
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Absolute address, B-1 
ACCESS proc call, 3-1 
Account number 
overriding, 2-60 
specifying, 2-41 
ALLOC proc call, 3-3 
Allowing a BAL program to communicate 

with another HAL program, 2-19 
ALTER statement, 2-1 
Altering load modules at execution time, 2-1 
Alternate SAT libraiy file, 2-3 
ALTJCS statement, 2-3 
ANSI 1974 COBOL language processor, 3-23 
ASM proc call, 3-7 
Assembler listing 

C compiler, 3-20,3-21 
specifying format, 3-11 
Assembler language code, 

C compiler, 3-20 
Assembly language processor, 3-7 
Assigning 

global status to named set symbols, 2-30 
same logical imit number to a disk 
volume that has different files, 
3-39 
same logical unit number to a diskette 
volume that has different files, 
3-38 
same logical unit number to a tape 
volume that has different files, 
3-40 
AUTO proc call, 3-13 
Automatic inclusion, 3-59 

B 

BAL programs 

communicating with another BAL 

program, 2-19 
restarting, 2-77 



Binary overflow interrupt, 2-60 

Blocks, B-1 

Branch 

conditional, 2-32 

statements, inserting labels, 2-58 
imconditional, 2-31 
Bypassing portions of the control stream 
conditionally or unconditionally, 
2-89 



Card punch, assigning, A-2 
Card reader 

assigning, A-2 

terminating operations, 2-28 
CAT statement, 2-5 
Catalog 

files, providing information, 2-47 

removing a file, 2-13 
C compiler, 3-19 
CC statement, 2-7 
CCOMP proc call, 3-19 
Changing 

data definitions at run time, 2-11 

value of global set symbols without 
changing its status, 2-43 
Character set, procedure definition 

statements, 1-8 
Character string, 1-8 
Checkpoint records, 2-77 
COBL74 proc call, 3-23 
COBL85 proc call, 3-28 
COBOL language processor, 3-28, 3-33 
COBOL proc call, 3-33 
COBOL programs, restarting, 2-77 
Coding conventions 

job control statements, 1-5 

proc definition statements, 1-7 
Commands, issuingfrom a job control 

stream, 2-7 
Comments field, 1-4 
Compare operation, 3-81 
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Compiler listing format 
AUTO proc call, 3-16 
CCOMP proc call, 3-21 
COBOL proc call, 3-36 
FORT proc call, 3-46, 3-47 
RPG II proc call, 3-70 

Conditional branching, 2-32 

Console, 2-37, 2-59 

Continuation line, 1-6 

Control stream 

considerations, 1-10 
typical, (figure) 1-3 

Controlling 

operating environments, 2-60 
output spooling 

SPOOL proc call, 3-73 
SPL statement, 2-90 

Copy libraries, 3-7, 3-11, 3-33 

Copy modules, 3-25, 3-30, 3-36 

CR statement, 2-8 

Cylinders, B-1 



Data 

end-of-data statement, 2-106 
start-of-data statement, 2-105 
Data definitions, changing at run time, 2-11 
DATA FILEID statement, 2-9 
Data management file definition, 2-55 
DATA STEP statement, 2-10 
Data utility routine, 3-76, 3-81, 3-84 
Date field, 2-82 
DD statement, 2-11 
DDP destinations, 2-75 
DDP program-to-program facility, 2-19 
DECAT statement, 2-13 
Decimal overflow interrupt, 2-60 
Declaring a local set symbol, 2-43 
Designating a logical unit number at 
SYSGENtime, A-1 



Device assignment 

card punch subsystems, A-2 

card reader subsystems, A-2 

description, 2-15, A-1 

disk subsystems, A-2 

diskette subsystems, A-2 

DVC statement, 2-15 

magnetic tape subsystems, A-2 

printers, A-1 

standard logical unit numbers, (table) 
A-3 

workstations, A-2 
Device assignment sets 

temporary work files, 3-88 

UDD proc call, 3-76 

UDT proc call, 3-81 

UPLCNV proc call, 3-83 

UTD proc call, 3-84 
Dialog processor, 2-94 
Disk volumes, 2-102 
Diskettes 

assigning and allocating space, 3-3 

assignment information, A-2 

copying or comparing, 3-76, 3-84 

DVCDKT proc call, 3-38 

obtaining space, 2-33 
Disks 

assigning and allocating space, 3-3 

assignment information, A-2 

copying or comparing, 3-76, 3-84 

DVCVOL proc call, 3-39 

obtaining space, 2-33 
Displaying a message at the system console 
or workstation 

JNOTE statement, 2-37 

OPR statement, 2-59 

PAUSE statement, 2-71 
DST statement, 2-14 
Dump-only printing, abbreviated, 2-60 
Dumps 

edited, 2-61, 2-68 

job region, 2-60 

turning off, 2-63 
DVC PROG statement, 2-19 
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DVC statement, 2-15 
DVCDKT proc call, 3-38 
DVCVOLproccall, 3-39 
DVCVTP proc call, 3-40 
Dynamic loading facility, 2-87 



Editor control statements, 3-70 
Embedded data 

inserting into a stored control stream, 2-8 

OPTION statement, 2-60 

replacement, identifying, 2-10 

symbol substitution, 2-61, 2-68 
END definition statement, 1-7 
End ofcontrol stream (/&) statement, 2-107 
End-of-data (/*) statement, 2-106 
END statement, 4-1 
Ending a procedure definition, 4-1 
EQU statement, 2-20 
Equating a logical unit number in a control 
stream with a device type in your 
system, 2-20 
Error log file 

AUTO proc call, 3-18 

COBL74 proc call, 3-27 

FORT proc call, 3-48 

RPG II proc call, 3-71 
Error messages, C compiler, 3-21 
Examining 

job-related values, 2-34 

system-related values, 2-35 
EXEC statement 

description and format, 2-21 

only search library, 2-64 
Expansion, dynamics, 2-87 
Exponent underflow exception interrupt, 

2-69 
EXT statement, 2-24 
Extent specifications, 3-78, B-1 



Facilities, determining availability of, 2-34, 

2-35 
File control block, LFD statement, 2-55 



File identifiers 

prefixing automatic qualifier, 2-73 

system libraiy file names, 1-11 
Files 

cataloging, 2-47 

copying or comparing {See UDD, UDT, 
and UTD proc calls.) 

definingin terms of extents, B-1 

linking control stream files with data 
management files, 2-55 

scratching, 2-82 

temporary work, 3-88 
FIN statement, 2-28 
Floating-point significant exception 

interrupt, 2-68 
FORT proc call, 3-41 
FORTRAN IV compiler restrictions, 3-48 
FORTRAN language processor, 3-41 
FOR77 proc call, 3-49 
FREE statement, 2-29 



6BL statement, 2-30 

Generating job and linkage editor control 

statements, 3-55 
Generating job control statements 

for device assignment sets used by the 

data utility routine, 3-76, 3-81, 

3-84 
for device assignment sets used by UTS 

400 up-line conversion routine, 

3-83 
required to assign a device to a job, 3-1 
required to assign a disk or diskette to a 

job step, 3-3 
to execute the ANSI 1974 COBOL 

language processor, 3-23 
to execute the COBOL language 

processor, 3-33 
to execute the FORTRAN language 

processor, 3-41 
to run an assembly language processor, 

3-7 
to run RPG II auto report, 3-13 
to run the RPG II language processor, 

3-66 
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Global set symbols 

changing value at run time from 

workstation, 2-72 
changing value witl>out changing status, 
2-43 
Global status, 2-30 
GO statement, 2-31 

H 

Hold status, 2-61 
Hyphenation, jobname, 2-38 



I 



Identifying 

input card data to be spooled, 2-9 

job, 2-38 

program to be executed, 2-21 

replacement embedded data for a saved or 
translatedjob control stream, 2-10 
IF statement, 2-32 
IGNORE parameter use restrictions, 2-17, 

2-56 
INCLUDE linkage editor control 

statement, 3-59 
Indicating the beginning of control 

information for a job, 2-38 
Indication field, 1-4 
Initiating another job, 2-79 
Input modules, 3-56 
Input reader, 2-9 
Input source library, 3-7 
INQ JOB statement, 2-34 
INQ SYS statement, 2-35 
Inserting 

embedded data temporarily into a stored 
control stream, 2-8 

labels, 2-58 
Issuing OS/3 system commands from within 
ajob control stream, 2-7 



JNOTE statement, 2-37 
Job control 

assigning devices, 3-3 

control streams (See Job control streams.) 

explanation, 1-1 

extent specification information, B-1 

generating device assignment sets for 
data utihiy routine, 3-76, 3-81 

logical unit number assignment 
information, A-1 

overview, 1-1 

procedure definition statements (See 

Procedure definition statements.) 

procs (See Job control procedure calls.) 

statements (See Job control statements.) 

system library file names, 1-11 
Job control procedure calls 

ACCESS, 3-1 

ALLOC, 3-3 

ASM, 3-7 

AUTO, 3-13 

CCOMP, 3-19 

COBL74, 3-23 

COBL85, 3-28 

COBOL, 3-33 

definition statements (See Procedure 
definition statements.) 

DVCDKT, 3-38 

DVCVOL, 3-39 

DVCVTP, 3-40 

FORT, 3-41 

FOR77, 3-49 

LINK, 3-55 

PASCAL, 3-62 

RPGII, 3-66 

SPOOL, 3-73 

UDD, 3-76 

UDT, 3-81 

UPLCNV, 3-83 

UTD, 3-84 

WORK/TEMP, 3-88 

WRTBIG/WRTSML, 3-91 

(See also Procedure definition.) 
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Job control statements 


RST, 2-77 


ALTER, 2-1 


RUN, 2-79 


ALTJCS, 2-3 


RV, 2-79 


CAT, 2-5 


SCR, 2-82 


CC, 2-7 


SET, 2-84 


coding conventions, 1-5 


SFT, 2-87 


continuation line, 1-6 


SKIP, 2-89 


CR, 2-8 


SPL, 2-90 


DATA FIT ,F,TD, 2-9 


start-of-data (/$) statement, 2-105 


DATA STEP, 2-10 


UID, 2-93 


DD, 2-11 


USE DP, 2-94 


DECAT, 2-13 


USE LIB, 2-95 


DST, 2-14 


USE MENU, 2-96 


DVC, 2-15 


USE SFS, 2-97 


DVC PROG, 2-19 


VFB, 2-99 


end of control stream (/&) statement, 


VOL, 2-102 


2-107 


Job control streams 


end-of-data (/*) statement, 2-106 


bypassing portions of, 2-89 


EQU, 2-20 


concepts, 1-2 


EXEC, 2-21 


considerations, procedure definition 


EXT, 2-24 


statements, 1-10 


FIN, 2-28 


ending, 2-107 


FREE, 2-29 


inserting data or statements, 2-8 


GBL, 2-30 


library file, 1-11 


general format, 1-4 


saving, 2-63, 2-67 


GO, 2-31 


typical, (figure) 1-3 


IF, 2-32 


Job log 


INQJOB, 2-34 


creating separate identifier, 2-62 


INQSYS, 2-35 


directing to printer or tape, 2-62 


JNOTE, 2-37 


Job-related values, 2-34 


JOB, 2-38 


Job run library, temporary, 1-11 


JSET, 2-43 


JOB statement 


LBL, 2-44 


description and format, 2-38 


LUB, 2-51 


overriding options, 2-60 


LFD, 2-55 


Jobs 


MTC, 2-57 


identifying, 2-38 


NOP, 2-58 


initiating other, 2-79 


OPR, 2-59 


saving in expanded state, 2-67 


OFl'ION, 2-60 


JSET statement, 2-43 


PARAM, 2-70 




PAUSE, 2-71 


mm 


procedure definition (See Procedure 


K 


definition statements.) 




QGBL, 2-72 


'KsyvforAs 


QUAL, 2-73 


KT.KN, 2-12 


REN, 2-74 


KLOC, 2-12 


ROUTE, 2-75 


SIZE, 2-12 
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Label field, 1-4 
Labels 

cataloging files, 2-47 

changing, 2-74 

disk, diskette, or tape volumes, 2-44 

inserting, 2-58 
LBL statement 

cataloging files, 2-47 

disk, diskette, or tape volumes, 2-44 
LCB statement, 2-51 
LFD statement, 2-55 
LINK proc call, 3-55 
Linkage editor 

AUTO proc call, 3-17 

executing, 3-55 

OPTION statement, 2-61 
Linking file information in the control stream 
with a data management file 
definition, 2-55 
Load code buffer, print file, overriding, 2-51 
Load library file, 1-11 
Load modules 

altering, 2-1 

creating, 3-55 
LOADM linkage editor control statement, 

3-59 
Local set symbols, 2-43 
Logical unit numbers 

assignment information, A-1 

DVCDKT proc call, 3-38 

DVCVOL proc call, 3-39 

DVCVTP proc call, 3-40 

equating with a device type, 2-20 

for card punch subsystems, A-2 

for card reader subsystems, A-2 

for disk subsystems, A-2 

for diskette subsystems, A-2 

for magnetic tape subsystems, A-2 

for printers, A-1 

for workstations, A-2 

standard assignments, (table) A-3 



M 

Macro library, 1-11, 3-10 

Magnetic tape subsystems, assigning, A-2 

Main storage, indicating, 2-39 

Maps, FORT proc call, 3-47 

Menu services, 2-96 

Messages, displaying, 2-37, 2-59, 2-71 

Monitor routine, 2-69 

MTC statement, 2-57 



N 



NAME statement, 4-2 
Non-SDMA printers, overriding system 
default load code buffer, 2-51 
NOP statement, 2-58 



Object library file, 1-11 

Obtaining disk or diskette space, 2-24 

Operand field 

special considerations concerning, 1-8, 
1-9 

values used in, 1-8 
Operation field, 1-4 
OPR statement, 2-59 
OPTION JOBDUMP statement, 

CCOMP proc call, 3-22 
OPTION statement 

ASM proc call, 3-7 

format and descriptions, 2-60 

restrictions, 2-69 
Options, specifying, 2-60 
Output, directing to specified 

destination, 2-65 
Output object library, 3-7 
Output spooling, controlling, 2-90, 3-73 
Overriding the system default load code 
biiffer, 2-51 
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Page sepaixttors, suppressing printing, 2-61 
PARAM statement 

ASM proc call, 3-7 

format and description, 2-70 
Parameter siibstitution, 1-9 
Parameters 

explanation, 1-9 

procediire definition statement, 1-9 

referencing, 1-9 
PASCAL proc call, 3-62 
PAUSE statement, 2-71 
Peripheral devices 

assigning, 2-15, A-1 

releasing, 2-29 
Positioning tape volumes prior to job step 

execution, 2-57 
Prefixing an automatic qualifier to 

siobsequent file-ids in a job, 2-73 
Print files, overriding system default load 

code buffer, 2-51 
Print option, overriding, 2-66 
Printed output, block letters, 3-91 
Printers, assigning, A-1 
Priority, establishing, 2-66 
Procedure definition 

control stream, calling, 4-5 

ending, 4-1 

naming, 4-2 

starting, 4-3 

statements {See Procedure definition 
statements.) 
Procedure definition statements 

character set, 1-8 

coding conventions, 1-7 

control stream considerations, 1-10 

description, 1-7 

END, 4-1 

NAME, 4-2 

parameter referencing, 1-9 

parameters, 1-9 

PROC, 4-3 

procname, 4-5 

terms, 1-8 



Procedure libraries, 3-7, 3-10 

Procedures (See Job control procedure calls.) 

Procname statement, 4-5 

Procs (See Job control procedure calls.) 

Program, switch list priority, 2-22 

Program-to-program facility, DDP, 2-19 

Programs 

BAL, 2-19, 2-77 

COBOL, 2-77 

submitting information during execution, 
2-70 
Providing information for cataloging files 

(LBL File Catalog), 2-47 
Punch dual output feature, 3-78 



QGBL statement, 2-72 
QUAL statement, 2-73 
Qualifiers, automatic, 2-73 



Reading control stream 

into job control stream library ($Y$JCS) 

or alternate SAT library file for 

permanent storage, 1-1 
into temporary job run library file 

($Y$RUN) for scheduling and 

execution, 1-1 
Reading or writing a source module 

sequentially, 2-95 
Referencing parameters, 1-9 
Relative switch list priority, 2-22 
Releasing volumes and peripheral devices 

assigned to a job, 2-29 
Remote batch processing (RBP) terminals, 

2-14 
Removing a file fi*om the catalog, 2-13 
REN statement restrictions, 2-74 
Renaming labels, 2-74 
Requesting the assignment of a peripheral 

device to a job, 2-15 
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Restarting a BAL or COBOL program after a 

malfunction, 2-77 
ROUTE statement, 2-75 
RPG II auto report, 3-13 
RPG II language processor, 3-66 
RPGIIproccall, 3-66 
RST statement, 2-77 
RST statement considerations, 2-78 
RUN statement, 2-79 
RV statement, 2-79 



SAT library file, specifying alternate, 2-3 

SCAN facility, resetting, 2-64 

SCR statement, 2-82 

Scratching files, 2-82 

Screen format services, 2-97 

SDMA printers, overriding system default 

load code buffer, 2-51 
Sending spooled output to RBP terminals, 

2-14 
Serial RU/RV runs, 2-68 
SET statement, 2-84 
Set S3anbols 

global status, 2-30 

local, declaring, 2-43 
Setting or modifying date fields, 2-84 
SPT statement, three applications of, 2-87 
Shared code modules, identifying, 2-87 
SKIP statement 

format and description, 2-89 

targets, inserting labels, 2-58 
Snapshot dumps, 2-60 
Source libraiy file, 1-11 
Specifying 

alternate SAT libraiy file to be searched 
forjprocs, 2-3 

destinations, 2-75 

dialog processor, 2-94 

optional features, 2-60 

workstation by user-id, device address, or 
both, 2-93 



SPL statement, 2-90 
SPOOL proc call, 3-73 
SPOOL proc call keyword restrictions, 3-73 
Start-of-data (/$) statement, 2-105 
Starting procedure definition, 4-3 
Statement conventions, viii, 1-5 
Statements {See Job control statements.) 
SUB facility, resetting, 2-64 
Submitting information during program 

execution, 2-70 
Supplying 

label information for files, 2-44 

procedure definition name, 4-2 

volume serial numbers, 2-102 
Symbol substitution, 2-61 
Symbols, 1-8 
System commands, issiiingfrom a job control 

stream, 2-7 
System console, displa3dng 

messages, 2-37, 2-59 
System library file names, 1-11 
System-related values, 2-35 
System 80 

card readers, A-2 

disk/diskette subsystems, A-2 

magnetic tape subsystems, A-2 

printers, A-1 



Tape files, copying or comparing, 3-81, 3-84 
Tape sxJbsystems, assigning, A-2 
Tape volumes 

DVCVTP statement, 3-40 

identifying, 2-102 

positioning, 2-57 
Task switching priority, 2-66 
TEMP proc call, 3-88 
Temporary work files, 3-88 
Terminating card reader operations, 2-28 
Tracks, B-1 
Transfer address, 3-61 
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UDDproccall, 3-76 

UDTproccall, 3-81 

UID statement, 2-93 

Unconditional branching- 2-31 

UPLCLNVproccall, 3-83 

USE DP statement, 2-94 

USE LIB statement, 2-95 

USE MENU statement, 2-96 

USE SFS statement, 2-97 

User program switch indicator (UPSI), 2-84 

UTDproccall, 3-84 

UTS 400 up-line conversion routine, 3-83 



w 

WORK proc call, 3-88 
Workstations 

assigning as master, 2-62 

assigning as originator, 2-65 

assignment information, A-2 

changing control stream execution, 2-65 

changing globsd set symbols, 2-72 

dialog processor, 2-94 

displaying messages, 2-37, 2-59 

menu services, 2-96 

screen format sessions, 2-97 

specifying, 2-93 
WRT BIG proc call, 3-91 
WRTSML proc call, 3-91 



o 



Vertical format buffer, overriding system 

default, 2-99 
VFB statement, 2-99 
VFB statement considerations, 2-100 
VOL SCRATCH statement, specifying, 2-18 
VOL statement, 2-102 
Volume serial numbers, 2-102 
Volumes 

releasing, 2-29 

tape, positioning, 2-57 



o 



UP-9984Rev.2 



lndex-9 
Update A 



o 



o 



